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EDITORIAL 



It seems that Atari Corp. is going 
through a major reorganization these 
days. Most will agree that Atari needed to 
do something to focus their computer bus- 
iness, and it seems that Atari has come to 
the same conclusion. Recently, they set up 
a new computer division called — simply 
enough— Atari Computer. Whether this 
means that we'll see the employ- 
ment of some new marketing 
strategies, no one is really sure, 
but the word "advertising" has 
been bandied about quite a lot 
lately, and it could be that— at 
last — ST computers will be get- 
ting the exposure they need to 
ensure success. 

According to Atari's Neil Har- 
ris, the Sunnyvale company's 
marketing organization is get- 
ting revamped. Mentioned in a 
recent DELPHI conference were 
the formation of a telemarketing 
group and the taking on of a 
new public-relations agency, one 
that specializes in computers. 
Changes for the future also in- 
clude a new advertising agency. 

"Reading the tea leaves," com- 
mented Harris, "I have to think 
this means that corporate 
management is getting very seri- 
ous about the USA. They would 
not be letting us spend the 
money to do all this, otherwise." 

This statement, while provid- 
ing hope for Atari's supporters 
in the U.S., concedes the fact 
that Atari has been side- 
stepping the U.S. market 
favor of the higher European 
sales — something that we've all come to 
realize over the last couple of years. Of 



by Clayton Walnum 




course, one can't blame Atari for going 
where the paper is greener. They are, af- 
ter all, a small company with limited 
resources, able to spread themselves only 
so thinly before they cease to be able to 
function. The lack of attention granted 
the U.S., however, has made a great many 
people wary of the STs and has made 
others — people who have al- 
ready purchased their STs and 
fear for the future of their 
investment — downright bitter. 

While many past promises 
from Atari have come to naught, 
I have a feeling that this time we 
may see some change. Atari has 
to have realized by now that if 
they ignore it much longer, the 
U.S. market will slip away from 
them. They've played the wait- 
ing game long enough. It's time 
to tackle the U.S. with aggressive 
marketing strategies — time to 
grab every American contem- 
plating a computer purchase 
and scream, "Power without the 
price!" into their faces so loud- 
ly that they have to respond. In 
this media-saturated society, the 
winners are those who scream 
the loudest. 

You and I have known for a 
long time that the ST is some- 
thing special, and it's only 
natural for us to want to share 
it with our fellow citizens. It's ST 
Log's hope that Atari is now 
ready to bring the rest of the 
US. in on our little secret, that 
they have at last realized that 
the time has come to display the 
ST to the American people in a way that 
cannot be ignored. 
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VIP Service 

As the frustrated owner of a 1040ST 
unable to videotape my creations, I 
was thrilled when I received a call from 
Practical Solutions, asking if I was still in- 
terested in the Videokey converter. My 
overwhelming "Yes!" still bellowing over 
the phone lines, I received my Videokey 
a week later. 

I promptly hooked it up, and after a 
minute adjustment, per the included in- 
structions, I was in business. Most of the 
colors looked fine, but I had a problem 
with oversaturation of certain blues on 
my composite monitor. The problem 
looked worse upon viewing the videotape 
back. These blues were from the CAD 3-D 
demos I had made. 

A call to Practical Solutions returned 
me a call from Mark, one of their en- 
gineers. I explained my problem to a 
friendly, sympathetic and knowledgeable 
person who kindly told me to send it back 
for a modification. I included a videotape 
to help describe my problem with the 
oversaturated blues. 

Ten days later, I received my Videokey 
along with my videotape and a personal 
letter thanking me for my description and 
cooperation. Practical Solutions also 
videotaped some pictures onto my tape 
after their modification, so I could see 
what they did. The next day at work, their 
product service rep called me to follow- 
up on my problem. He asked if I had 
received the Videokey and if I was satis- 
fied. He also stressed that if there were 
any other problems to call right away so 
they could help out. 

I cannot remember ever getting this 
VIP service from any company before. 
Practical Solutions is a first-class, profes- 
sional, customer-oriented organization 



that really cares about the consumer. I 
would recommend its products and serv- 
ices without reservation, and its support 
of the Atari ST is a benefit for all of us. 
It deserves our support. Thanks to all at 
Practical Solutions for the help and sin- 
cerity. — Barry Summer 

Brooklyn, NY 

Thank you for sharing your experience. It's al- 
ways a pleasure to print this type of letter. Be- 
cause we feel that the quality of a company's 
customer support is just as important as the 
quality of the products they sell, we believe that 
outfits such as Practical Solutions should be 
publicly applauded when it shows its customers 
consideration over and above the norm. Com- 
panies like this do more than satisfy their cus- 
tomers; they also help build up the ST's 
reputation. 

The Adventure Continues 

I read your review of my adventure book 
I in the May issue of ST-Log and wish to 
personally thank you for the kind words. 
With reference to some of the statements 
in the review, I thought that a few words 
of clarification are in order. 

First of all, the reference to the previ- 
ous Arrays adventure books was done 
strictly as a matter of courtesy. For many 
years, I myself was an active reviewer of 
entertainment and educational software 
for Arrays, Inc., since at that time it was 
also publishing The Apple Book of Software, 
a series of softcover books dedicated to 
Apple II software reviews. During that 
period of time, I made personal acquain- 
tance with Kim Schutte, the author of The 
Book of Adventure Games, Vol. I & II, and, 
in fact, was acknowledged in Volume II 
for my help thereof. The reason I speak 
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in the past rather than present tense of 
my relations with Arrays is that it is no 
longer in the book publishing business. 
Thus, the reference to a volume III of The 
Book of Adventure Games is not a reality. The 
fact is that I have maintained my relations 
with Kim and thus know of his activities. 
At times, he has entertained the notion 
of another adventure game book but, to 
the best of my knowledge, has not gone 
forth with the venture. If he does indeed 
decide to do so, it certainly won't be with 
Arrays. Thus, in summary, there is no one 
at Arrays "jumping out of a window with 
volume III" although, if it had any smarts, 
it would have continued to put out such 
books. For a long time, that was the only 
profit-making venture it had and what 
kept it solvent for so long. 

Although my book resembles the Ar- 
rays books in format, it differs in 
some significant ways. The idea of scram- 
bling the clues in the simple-to-use and 
efficient way in which it is handled is 
something I am very proud of. Indeed, 
the review in the January issue of A + 
Magazine gave credit to this feature. Also, 
the inclusion of "walk thrus" is a new fea- 
ture which I have personally received 
many compliments for. At the least, it 
saves on a lot of fan mail coming from 
people asking for more clues than those 
I have provided. 

With regard to the production of the 
book itself, you are correct in assuming 
that it was done on an Apple II. The book 
was produced by a friend of mine, Jerry 



Jones (see the acknowledgments), on a 
Macintosh Plus using a combination of 
MacDraw, MacWrite and PageMaker. I my- 
self prepared (and typed) the rough draft 
on an Apple II but the final camera-ready 
copy was done as described above. 

Finally, if you liked Book I of Keys to 
Solving Computer Adventure Games you will 
surely like Book II, which was released 
early this year and is doing quite well thus 
far. Although the format is the same, the 
games contained in the second book are, 
of course, different and much more cur- 
rent (most are of 1987 vintage). Also, the 
overall appearance of the production is 
much more elegant (just look at the title 
pages, and the clue sheets, and you will 
immediately see the difference). 

By the way, Book III is in the works. 
I have played, finished and prepared 
the material for 14 new games (e.g., Don- 
dra, Beyond Zork, Sherlock Holmes in 
Riddle of the Jewels, King's Quest III, 
Plundered Hearts, etc) thus far and essen- 
tially am at the point of waiting for more 
adventure games to be issued. 

— Marvin K. Simon, Author 
Keys to Solving Computer Adventure Games 

Thank you for the extra information and clarifi- 
cations, Marvin. We wish you the best of suc- 
cess with your future projects and can assure 
you that reviews of your new books will grace 
the pages of ST-Log. There's only one question 
left unanswered: How the devil do you fit 
enough hours in the day to finish all those 
games? 
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Michtron Introduces New 
Titles 

Slaygon is a new arcade-style maze 
game from Michtron. The game offers a 
graphical 3-D maze game along the lines 
of Dungeons & Dragons. As a voyager you 
travel through a building of corridors and 
rooms picking up objects. The game has 
good graphics and a price of $39.95. 

GFA Artist, $79.95, is an animation and 
graphics program. Similar to DEGAS 
Elite, images are developed using a stan- 
dard painting metaphor. Animation 
scripts are created to animate the sprites. 
The program can generate more than 
1,000 colors per screen. 

Michtron is now also an educational 
software supplier. The new Kidprogs is 
geared towards preschool children. For 
$39.95, it offers elementary interaction 
with music, pictures and the alphabet. 
ABZOO ($29.95), is a letter recognition 
program for toddlers. The screen shows 
pictures of objects that correspond with 
keys on the ST keyboard. Invasion is a 
$29.95 typing tutor program where letters 
and words appear at the top of the screen 
and tumble downward until the cor- 
responding key is pressed on the 
keyboard. 

Michtron 
576 S Telegraph 
Pontiac, MI 48053 
(313) 334-5700 
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NEWS 



Supra Corp. 
has begun 
shipping a 
45-Megabyte 
hard disk 

that is 
installed 
inside a 
Mega ST. 



CompuServe Vendors Forum 

A new service is being offered to Com- 
puServe users. The online modem serv- 
ice now has a forum devoted to Atari 
software and hardware vendors. The 
ATARIVEN forum is split into several 
company topics, with the manufacturers 
supporting their own topics. Currently 
the following companies can be found in 
the Vendors Forum: 

Atari Explorer Magazine 74710,13 

Data Pacific 76004,1612 

ICD, Inc. 76004,1600 

Intersect 76004,1577 

Michtron 76004,1607 

QMI, Inc. 76004,1601 

Regent Software 76004,1573 

ANALOG and ST-Log magazines will 
also be participating in the new forum. 
Type GO ATARTVEN for more informa- 
tion on CompuServe. 

CompuServe 

5000 Arlington Center Blvd. 
Columbus, OH 43220 
(614) 457-0802 

CIRCLE #131 ON READER SERVICE CARD. 
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Publishing Partner 2 

The 1986 release of Publishing Partner 
(PP) was heralded as the answer to the 
missing Atari desktop publishing system. 
At $149.95, PP was a bargain. Soft Logik 
has now released Publishing Partner 
Professional. At a high retail price of 
$199.95, the new system sports auto-text 
flow around graphic images, auto hyphe- 
nation, kearning, an UNDO command, 
special text effects like slant, twist and ro- 
tate, and more included fonts. Word- 
processor files may be imported directly 
from WordPerfect, First Word, Regent 
Word II and Word Writer files. Upgrades 
for PP 1.1 owners are available directly 
from Soft Logik at a cost of $99. PP 1.1 
will continue to be marketed at a lower 
price, so you will have the option to try 
the lower priced package first, then up- 
grade to PP Professional later. 

Soft Logik 

11137 S. Town Square -C 
St Louis, MO 63123 
(314) 894-8608 
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Tackle Your ST 

Jefferson Software is now shipping the 
Tackle Box ST, literally more than 1,000 
pages of information on GEM and the ST 
packaged into what looks like a fishing 
tackle box. The package sells for only 
$69.95 and even includes GDOS support. 
Jefferson sells their own GEM version of 
Modula 2 — Modula is an interesting lan- 
guage that is the successor to Pascal. JS 
Modula 2 includes source code for GEM 
and TOS application development at a 
cost of only $49.95. Jefferson also sells 
XPRO Prolog, a fifth generation artifical 
intelligence language that conforms to 
the Edinburgh standard syntax for only 
$59.95. 

Jefferson Software 
12416 N. 28 Drive -18-236 
Phoenix, AZ 85029 
(602) 243-3106 
(602) 276-6102 (JS BBS) 
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Software is 
now shipping 
more than 
1,000 pages 
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on GEM and 

the ST 
packaged to 
look like a 
fishing tackle 
box. 

Supra Ships New Drives 

Supra Corp. the leading hard-disk sup- 
plier to the Atari market, has released the 
FD10, a 10-megabyte removable floppy- 
disk drive that runs about as fast as a nor- 
mal hard disk. With the FD10 you can 
change disks, impossible for a hard disk, 
so backing up your information is easy. 
The FD10 sells for $895.00. 

Supra has also begun shipping a 
45-Megabyte hard disk that is installed in- 
side a Mega ST. The unit is installed by 
Supra dealers. At a cost of $1,095, the new 
Supra unit is quite a bargain. 

Finally, Supra has announced that all 
of their hard-disk drives will use a 
redesigned controller which includes out- 
put to SCSI hard disks and DMA devices 
(such as the Atari hard disk or Atari Laser 
Printer). The new controller also has a 
battery-powered clock to reset your ST's 
internal clock whenever you turn on your 
ST. Upgrading your existing Supra con- 
troller will cost approximately $100. Con- 
tact Supra for more information. 

Supra Corp. 
1133 Commerical Way 
Albany, OR 97321 
(503) 967-9075 

CIRCLE #135 ON READER SERVICE CARD 



Desktop Publisher ST 

Timeworks has introduced a desktop 
publishing system for the ST. At $129.95, 
Timeworks' new product becomes the 
third DTP package for the ST after the 
successful Publishing Partner and Fleet 
Street Publisher DTPs. Timeworks' Desk- 
top Publisher ST is different from the 
other DTPs, as it includes a word proces- 
sor to enter your text. Page layout, graphic 
setups and typesetting abilities are all in- 
cluded, allowing the user to move freely 
between all of its functions. The program 
is GEM based and was written by the same 
people that developed 1st Word in En- 
gland. DEGAS, Neochrome, GEM Draw 
and Easy Draw graphic files may be im- 
ported. Text from Word Writer, 1st Word, 
WordPerfect, Regent Word II and ASCII 
files may be imported. Kearning and lead- 
ing are supported with automatic text 
flow. 

Timeworks 
444 Lake Cook Road 
Deerfield, IL 60015 
(312) 948-9200 

CIRCLE #134 ON READER SERVICE CARD 




GEM Directory 

Digital Research of the United King- 
dom has published a directory of GEM 
applications for the IBM PC and the Atari 
ST. The directory gives an overview of 
what GEM is and how the standard 
graphical user interface has evolved. Then 
more than 200 listings of GEM applica- 
tions are given. The listings include sum- 
maries of features, file format support, 
national language support and minimum 
system configuration. The directory 
cleaves between ST and PC products. 
However, since it is published in the UK, 
many of the ST products are those un- 
usual European programs you hear so 
much about. 

Digital Research (UK) 

Dept GEM, 70 West Way, Botley 

Oxford OX2 9JT, ENGLAND 

CIRCLE #136 ON READER SERVICE CARD 
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by TG 



Did you hear? At least a half a dozen 
companies have been trying to 
license Dr. T's multi-tasking operating sys- 
tem for use on their non-music applica- 
tions. The Dr. is thinking about it — more 
to follow next month. 

If someone hasn't already told you, 
Atari will be shipping the Imagen Post- 
script software clone for their laser 
printer within the next 30 days. The 
product is technically called UltraScript 
and is a full Postscript clone. Imagen is 
a division of QMS corporation and its 
reputation is one of quality products and 
full compatibility with the postscript stan- 
dard as set by Adobe, Corp. Imagen has 
had a fast text rotation and display system 
for quite some time now, and their new 
Postscript compatible version is said to be 
quite a bit faster than the routines provid- 
ed by Adobe systems. The emulator will 
load off disk much as GDOS does. By us- 
ing this disk-based system Atari will be 
able to continue to offer full support for 
products already released designed to run 
under the current GDOS system. 

This makes the story that Atari is 
preparing to offer bundled systems con- 
siderably more interesting. The story goes 
as follows: Atari will be supplying Mega 
dealers with a complete desktop- 
publishing system which consists of a 
monochrome Mega 4, an Atari laser 
printer and Publishing Partner II. Atari 
is also considering several other bundled 
systems featuring their Megas and soft- 
ware. In effect, these will allow the deal- 
er to set himself up as a VAR (value added 
dealer) without any heavy investment in 
either hardware or custom software. 



Rumors concerning the new STL (ST 
Laptop) have reached a fever pitch. It 
seems a forgone conclusion that the 
project is being worked on at Atari and 
the only major questions left concern the 
type of screen display to be offered and, 
of course, the big one. . .when? 

Among the strong possibilities for the 
fall season is a cartridge containing a PC 
emulator to be marketed by Atari 
Corp. This cartridge is expected to 
be quite a bit faster than the current 
version of PC Ditto since it will be 
ROM-based rather than requiring 
you to load and run software from 
a disk. While we are on the subject 
of a faster PC Ditto type program, 
we hear from Bill Teal, the author 
of PC Ditto, that the newest version 
is much faster than the current one, 
but there are still a few bugs to be 
ironed out. Bill is the kind of guy 
who will not release (or even 
promise to release) something be- 
fore he knows it's ready. 

The ST is now the hottest com- 
puter in the world for two specific 
applications. One that I'm sure you 
already know about is music; the se- 
cond is chess. When the Russian 
world chess champion played an ex- 
hibition match in Norway (playing 
against 30 players with master rat- 
ings) about two months ago, he was shown 
a new chess database. After viewing the 
information on their games as stored and 
displayed in this database program, he 
remarked that he would be willing to 
return to play again the following year 
only if he were given a copy of the pro- 
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gram and an ST to run it on in lieu of 
pay. The news of his remarks has swept 
the chess underground (yes, of course 
there is a chess underground). The pack- 
age is at this point not available in En- 
glish, but expect that to change shortly. 

Where is the new Exel clone that Atari 
was showing in Hanover last April? Sever- 
al reps from Michtron were at the show 
and saw a copy of this package which they 
called extraordinary. 

The final revision of WordPerfect has 
been out a while now, and it's working the 
way we all knew it would. The company 
admitted that they may have released the 
product early but made up for this eager- 
ness by sending out countless free up- 
grade disks to all registered owners. 
Quality will out! 

As many of you already know, David 
Small of Magic Sac fame has moved on 
from Data Pacific to other things. AT&T 
offered him an outstanding opportunity, 
with a chance to work on much larger sys- 
tems. Too bad Atari didn't have a chance 
to grab him and put him to work in their 
overworked programming dept. 

It's official: Dungeon Master from FTL 
is the best-selling ST software of all 
time. . . . 

Is shareware worth writing for the ST? 
We have talked to several authors who 
have products in the shareware market for 
both the Atari ST and other makes of 
computers. They report that the owners 
of Ataris seem to be the cheapest PC own- 
ers they write software for. This is too bad, 
since much of the shareware for other 
computers is actually better than the com- 
mercial software it competes with. I would 
guess that a product like ARC.TTP is used 
by at least 50,000 people on a fairly regu- 
lar basis, yet the author has not received 
contributions that would equal even 10< 
per user. 

Heard about the new GEM for the ST? 
A rather seedy looking individual with a 
strong foreign accent sat down at my ta- 
ble last night as I was finishing off an 
evening drink. He whispered in my ear 
that GEM 2.2 is now being marketed in 
Germany. It seems that another compa- 
ny (in other words: not Atari) is offering 
the package, and it's a beauty. You can buy 
it with GEM Write, GEM Paint and GEM 
Draw or any combination of those titles, 
and it appears that all the bugs built into 
the original GEM have been fixed. And 
fast! It's written in 100% machine lan- 
guage and performs like the Tempus text 
editor. The German price is around 
300dm. A quick calculation told me that 
this is around $148.00 U.S., and I had my 



checkbook out in a flash. Unfortunately, 
there is no U.S. importer for the product 
yet. Anyone with overseas connections 
want to make a small fortune? 

The corporate restructuring at Atari 
continues with titles and responsibilities 
being moved around like playing pieces 
on a checkerboard. What will come of it? 
Advertising. Look for those that wind up 
with the responsibility for making Atari 
Computer Corp. fly (yes, I mean a new 
company created under the banner of 
Atari, Corp.), finally deciding to spend a 
little money to tell the non-ST owners what 
we've been keeping secret for so long — 
that the Atari is one of the most powerful 
machines in the under $3000 class. 

Best guess is that the total number of 
software titles on sale in Europe is about 
double that of the titles in the U.S. With 
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a little advertising support from Atari, the 
chances are good that more of these titles 
would find their way here and with them 
would come an increased interest in the 
ST and its "broad software base." This 
would of course lead to more sales of the 
ST, which would lead to more software be- 
ing written for the ST, which would lead 
to more ST sales, which ... Is it any wonder 
that the owners of STs are the ones push- 
ing for more advertising for the product? 

Networking for the ST (under GEM) is 
at least six months away. When the ST was 
first released the idea of a MIDI network 
seemed natural for the machine, since 
MIDI is faster than the RS232 port that 
is used in many low-cost systems. Unfor- 
tunately there is a bug in the GEM system 
which has beaten everyone we know of 
who has tried to write a reasonably fast 
MIDI network system. As far as help from 
Atari goes, there seems to be little they 
can or will do. Could this be because they 
have announced that they will be ship- 
ping their own PromisedLan sometime? 
PS. "Sometime" looks like the beginning 
of '89 at the earliest. 

The new high-speed dBMAN compiler 
might make the dBMAN version IV the 
single most-popular programing environ- 
ment available on the ST for small VARs. 
This little database blows away some of 
the biggest names in the PC world and 
does it at a price that makes the compe- 
tition turn white with fear. It is a source 
of constant amazement to me that a pack- 
age like dBMAN — which is a complete 
dBASE — clone does not do better in the 
ST world than it does. dBASE has become 
one of the standards of the business world 
with less power than dBMAN. There are 
literally thousands of business applica- 
tions written in dBASE currently being 
sold to IBM owners. As an extra bonus 
you can buy the ST and dBMAN for a low- 
cost development system, and then use 
the IBM version of the compiler to com- 
pile your code to run on the IBM's. The 
features and syntax are identical. 

TG can often be found skulking the turf around 
Hollywood and Vine. He is often seen frequent- 
ing bars in the area, carrying what he calls the 
only true portable computer: an ST plugged into 
a heavy-duty truck battery. He writes this 
column to make a living until he breaks into 
film and to provide the cash he needs to recharge 
his truck battery every month. Heard anything 
good! Write it down and stick it with used gum 
on the underside of the payphone at the address 
above. (Don't live in La-la land? Then send TG's 
mail to: ST-Log 91 71 Wilshire Blvd., Suite 300, 
Beverly Hills, CA 90210.) 
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DATABASE 

DELPHI 



As we noted last month, the ST contin- 
gent on Delphi has been moved to a 
separate area. You may access the new ST 
SIG by typing "ST" at the Group > 
prompt. Here's how the entry to the ST 
area looks (thanks to Maurice Molyneaux 
(MAURICEM) for the logo). 



/~ 7/ _J ■ 

/ / /_/ 7 / 

/ / / / , 

/ , / / / , n / ZL /nzj 

_I 7 / / / /Z7 // t ff // /— 
/ / / / / / /J // /J / 
/ / /_/ / 17/ // / 

welcomes you to the DELPHI Atari ST SIG 



Announcements 
Conference 
Databases 
Entry Log 
Forum (Messages) 
MAIL (Electronic) 
Member Directory 
Poll 



Request Free Upload 

Set Preferences 

Topic Descriptions 

Who ' s Here 

Workspace 

Help 

Exit 



Atari ST>What do you want to do? 

The menu is much the same as in the 
8-bit area, so familiarity should reign. For 
obvious reasons, the topics within the ST 
SIG — for forum messages and database 
entries — have been changed from the 
topics in the ANALOG/Atari SIG. Here's 
what we've got to work with now: 



Desktop Publishing 
Educational 
Telecommunications 
News & Reviews 
Current Issue 
Recent Arrivals 



General Information 

Applications 

Games & Entertainment 

Art 

Programming 

Utilities 

Sound & Graphics 



The recent "recent arrivals" 
arrival 

On the list, you'll see a category called 
"Recent Arrivals." This category was re- 
quested by popular demand (as voted on 
by the masses after a Poll was created to 
settle the debate), based on MADMODI- 
FIER's (Lloyd Pulley) recommendation. 

His view was that with all the topics 
available, it could take a while to select a 
topic, run through the entries until you 
caught up with your last search, repeat 
the process with the next section, and so 
on. With a Recent Arrivals area, you have 
to pop only into that section for new files; 



if you're looking for older entries, they 
can be found in their designated areas. 
Files will only reside in the Recent Ar- 
rivals topic for a couple of weeks, at the 
most, giving everyone a chance to scan 
and download them from there. 

The "Applications" topic will cover 
most of what was in the "ST Programs" 
area prior to the split; the other topic 
names are mostly self-explanatory. Keep 
in mind that we are always looking for 
new public domain files to offer to our 
online visitors, so if you get an interest- 
ing or helpful file from another user or 
local BBS (or have written it by yourself), 
please submit it to us for inclusion in the 
libraries. 

Okay! I submit! 

If you are new to submitting software, 
it can be somewhat intimidating. Here's 
an overview of the process: 

The first thing to do is request time for 
uploading. Most of the major online serv- 
ices now offer free uploading, as an in- 
centive to building up the software 
libraries. In Delphi's case, they prefer to 
keep file repetition down to a minimum 
by having the SIG managers confirm what 
a user is going to upload and when. To 
request free time, simply type "REQUEST 
FREE UPLOAD" (or "REQ" for short) at 
the main SIG prompts — that's what I love 
about Delphi: its easy-to-understand, En- 
glish command set. Completing a short 
online form will leave a note for the SIG 
manager, who will then set up an appoint- 
ment (based on your request form). Af- 
ter the appointment is logged in, you'll 
get a confirmation through E-mail. 

After you're given the go-ahead, the 
next step is to upload the file to your 
Workspace. Entering "WOR" (short for 
WORKSPACE) at either the ANALOG > 
or Atari ST> prompt will bring you there. 
This Workspace is where Delphi stores 
your mail file (MAIL.MAI) and large mail 
messages, and where you can store files 



by Andy Eddy 

and messages of interest. This is your per- 
sonal storage area and no one else has ac- 
cess to it. Remember there is a charge for 
storage over 50 blocks (Delphi's blocks are 
512 bytes in size), which is billed at the 
start of each month, so be sure you fre- 
quently peruse your Workspace and de- 
lete unwanted files. To get the current 
charges, type "RAT POL" (short for 
RATES POLICY) from the "Using Delphi" 
selection off the main menu; at the time 
of this writing, the surcharge was 16 cents 
for every two additional blocks. 

The actual transfer of the file(s) will be 
taken care of by your terminal software. 
Virtually all commercial telecommunica- 
tions packages — Flashl and Interlink for the 
ST, for example, are very popular and 
strongly recommended — are program- 
med for a variety of protocols, as there are 
many methods of doing this: ASCII (for 
text files), Xmodem, Ymodem (for binary 
files), Ymodem Batch, Kermit (for multi- 
ple file transfers), etc. Further informa- 
tion on these can be found by typing 
"OTHER" and "NEW" at the WS> 
prompt. Make sure you use the same 
transfer protocol as you select from the 
Workspace menu. 

Once the file resides in your Work- 
space, you are ready to move it to the data- 
bases. From any Database topic prompt 
or the WS > prompt, type "SUB" (short 
for SUBMIT) and follow the prompts — 
just be sure when you submit, that you are 
in the SIG the file should be posted in. 
Figure 1 shows a sample submission, with 
my entries in capital letters and notations 
in []. 

Holding out until the house 
is finished 

Once that procedure is completed, 
don't fret if your file and description are 
not immediately visible in the selected 
area. The reason for this is that it will first 
go to a holding area for checking by the 
Sysops. This ensures that the file is not 
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a duplication of another user's entry and 
that the fde is intended for public view- 
ing. Once this previewing is completed, 
the file will be moved into the public 
areas for all to see 

Name: SUBMISSION RUN-THROUGH 
Type: MISCELLANEOU 

Date: 21-APR-1988 21:14 by ANAL0G2 
Size: 8034 Count: 0 

THIS IS A TEXT FILE OF HOW TO SUBMIT FILES FOR THE 
DATABASES . . . 

Topic: News & Reviews 
Keywords: OTHER, TEXT, SAMPLE 

One more thing to note: When you're 
finished with your transfer and submis- 
sion process, you'll have some free time 
to peruse the area and download some 
files on our nickel. Consider this a reward 
for your hard work. The databases are 
one of the most heavily accessed areas of 
any SIG, which means an investment 
return for the SIG managers. Your con- 
tribution is valuable to everyone, especial- 
ly if the program is one that helps the 
users save time or accomplish something 
they normally couldn't as easily. A good 
example is Charles F.Johnson's (CFJ) Arc- 
Shell program (originally published in the 
April 1987 ST-Log, but it has gone 
through a number of substantial upgrades 
since that time), which frees you from 
remembering the parameters to enter 
into ARC.TTP. 

Let your fingers do the 
talking 

We're doing our best to bring some of 
the major ST software developers online 
for product support and formal confer- 
ences. The latter lets the users conduct a 
press conference, with the manufacturer 
in the hot seat. By the time you read this, 
we'll most likely have had representatives 
from Michtron, FTL and Atari in CO (the 
abbreviation for conference) to tackle 
your questions in real-time. 

To keep up with the events of this sort 
and when they will take place in the Atari 
SIGs, be sure to read the brief notices that 
come up when you enter. As well, there 
is an Announcements area that lets you 
read through these notices. By typing 
"AN" at either the ANALOG > or Atari 
ST> prompts, you can pick a specific 
area — Conference, Database, etc — to read 
what is developing. 

The most active of these areas is the 
What's New section, which contains the 
brief messages you see at entry to a SIG. 
Typing "SCAN" will show the list of mes- 
sages, in case you missed them the first 
time. Generally these messages are shown 
to a user once and not repeated. 

We've covered a lot of ground this ses- 
sion. Til) next month, C U online. . .. 



How many files will you be submitting? 1 [Files can be 
grouped; for example, a few picture files may belong under 
one description. ] 

which of the following BEST describes the file(s) you are 
submitting : 

Program or Program Pack 

Newsletter 

Article(s) 

Transcript 

Documentation 

Data (Graphics, etc.) 

Miscellaneous Text 

Filetype: MIS 

Topic? NEWS [Hitting a ? here would bring a list of the 
topics, but we are targeting the News and Reviews section.] 

Enter a BRIEF description of the file you are submitting. 
Press control-z when complete or type /HELP for help. 

THIS IS A TEXT FILE OF HOW TO SUBMIT FILES FOR THE 
DATABASES. . . 

-z 

Primary Keyword: ? [This ? gives a list of available 
keywords for the topic you entered.] 

The file you are submitting for publication in News & 
Reviews must be given one of the following PRIMARY keywords: 

Games 

Utilities 

Applications 

Programming 

Other 

Primary Keyword: OTHER 
Primary Keyword: Other 

You may now supply any optional keyword (s) of your choice, 

subject to review by the database manager. Please enter one 

keyword or phrase per line, and enter a blank line or CTRL/Z 

when complete. 

>TEXT 

>SAMPLE 

> 

Workspace filename: TEST. TXT 

Now enter the "name" of the file as you wish it to appear in 
the directory. 

Display Name: SUBMISSION RUN-THROUGH 
Please wait. 

Would you like the file "TEST . TXT " deleted from your 
workspace? (Y/N) Y 

Your submission is complete. Thank you. 

Figure 1. 

Make the Delphi connection! 

As a reader of ST-Log, you are entitled to take ad- 
vantage of a special Delphi membership offer. For 
only $19.95 ($30 off the standard membership price!), 
you will receive a lifetime subscription to Delphi, a 
copy of the 500-page DELPHI: The Official Guide by 
Michael A. Banks, and a credit equal to one free, 
evening hour at standard connect rates. Almost any- 
one worldwide can access Delphi (using Tymnet, Tel- 
enet or other networking service) via a local 
telephone call. Make the Delphi connection by sign- 
ing up today! 

To join Delphi: 

1. Dial 617-576-0862 with any terminal or PC and mod- 
em (at 2400 bps, dial 576-2981). 

2. At the Username prompt, type JOINDELPHI. 

3. At the Password prompt, enter STLOG. 

For more information, call Delphi Member Services 
at 1-800-544-4005, or at 617-491-3393 from within 
Massachusetts or from outside the U.S. 



Delphi is a service of General Video-tex Corporation 
of Cambridge, Massachusetts. 




TUTORIAL 



Fby Kelly Schreiner 
or those of you who grew up 
programming on the 8-bit Ataris as 
I did, ST sprite programming should be 
a fairly routine task, because the ST's 
sprites are analogous in many ways to the 
Player/Missile graphics we were ac- 
customed to on the 8-bit machines. And 
for those of you that have never pro- 
grammed either sprites or Player/Missile 
graphics, this is the perfect time to learn 
sprite programming for the ST computer. 
But first, let's make some comparisons be- 
tween ST sprites and Player/Missile graph- 
ics, just so everybody knows what a sprite 
is to begin with. 

ST sprites and Player/Missile graphics 
are both user definable bit-block images 
stored in memory that can easily be 
moved around the screen independent of 
the background drawing. They both can 
have depth, (meaning that the first object 
drawn can pass in front of the second ob- 
ject, the second in front of the third and 
so on), and they both can have only one 
color. (Unless, of course, two or more ob- 
jects of differing colors are overlayed on 
top of each other). Both Player/Missile 
graphics and ST sprites are commonly 
used in games for arcade-type action on 
their respective computers. 

Now that the similarities between ST 
sprites and Player/Missile graphics have 
been looked at, let's examine the differ- 
ences between the two. One of the major 
differences between ST sprites and Play- 



er/Missile graphics is that the ST sprites 
are purely software-based sprites, not 
hardware-based, like Player/Missile graph- 
ics. The ST sprites are also limited in size; 
they measure 16x16 pixels instead of 8 
pixels wide by either 1-128 or 1-256 pix- 
els high for Player/Missile graphics. The 
ST sprites are considerably easier to 
create than Player/Missile graphics 
though, and you can have practical- 
ly as many sprites in a program as 
you want compared to the four 
players along with their missiles 
that Player/Missile graphics offers. 

As I said earlier, sprite program- 
ming on the ST computer is a rela- 
tively easy task to accomplish. That 
is, once you know how! The main 
reason for this is the fact that most 
of the work related to sprite 
programming is already done for 
you in the Line A opcodes, $A00D 

(DRAW SPRITE) and $A00C 

(UNDRAW SPRITE). 

By using the DRAW_SPRITE 
opcode, ($A00D), the sprite's X/Y 
coordinates on the screen can be es- 
tablished along with the sprite to be seen 
and its associated background buffer. 
The background buffer is needed to 
temporarily store the background be- 
hind the sprite, so that when the 
UNDRAW_SPRITE opcode is called to 
erase the sprite, the background can be 
restored to its original condition, just like 



To be able to 
program sprites 
on ST computers, 
you need to un- 
derstand the use 
of Line A 
opcodes. 
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it was before the sprite was drawn over it. 

That's basically all there is to program- 
ming sprites on the Atari ST. Now we'll get 
down to the heart of the matter and take 
an in-depth look at how to program the 
various structures needed to produce ST 
sprites. (This is also the code to use for 
drawing and erasing the sprites normal- 
ly, instead of the macro functions used in 
the program listing, just in case you don't 
have a macro assembler.) 

One of the most important things you 
need to understand to be able to program 
sprites on the ST computers is the use of 
the Line A opcodes. These opcodes are 
the very heart of the ST's powerful graph- 
ics capabilities. 

The software developers of the ST have 
made use of the fact that the 68000 
processor used in the Atari ST computers 
has two groups of opcodes which it does 
not understand, and which consequent- 
ly generate a software interrupt when en- 
countered in a program. These opcodes 
begin at memory locations $Axxx and 
$Fxxx. The Atari ST uses the $Axxx op- 
code trap, referred to as the Line A Han- 
dler, to access its graphics routines. The 
trap handler that processes this trap 



recognizes word opcodes that begin with 
the bits 1010 (hexadecimal A) as unim- 
plemented instructions and then jumps 
through a special exception vector, which 
in the ST's case points to the Line A rou- 
tines. The lower four bits of the word op- 
code used contain the number of the 
routine to be accessed. Only values be- 
tween $0 and $E are allowed here. That 
means that a total of 15 different opcodes 
are available for the Line A graphics rou- 
tines. This number includes the initiali- 
zation opcode, though, so there are 
actually only 14 graphics routines. In this 
demo program only the word opcodes 
$A000, $A00C, and $A00D are used, so I 
will confine myself to describing those. 

In order to use the Line A opcodes you 
must first label the word opcode func- 
tions you want to use in your program. 
Here is the way these functions are la- 
beled in the demo program SPRITES. 

LINE-AI s SA808 initialization opcode 

DRAM-SPRITE = SA08D ;Drau sprite opcode 
UNDRhW_SPRITE 8 SAOOC ;Erase sprite opcode 

The next step is for you to initialize the 
Line A routines for use in the program. 
The opcode $A000, Initialize, is used to 
do this; it determines the address of the 



Line A routines. After calling this func- 
tion, data register DO and address register 
AO point to a table with the starting ad- 
dress of the Line A variables. Address 
register Al points to a table with the start- 
ing addresses for the three system font 
headers, and address register A2 points 
to a table that specifies the starting ad- 
dresses of the 15 Line A opcodes. There's 
no parameter required for this function, 
so all you have to do is call the word op- 
code label that you specified for the 
$A000 (Initialize) function. 

In order to draw a sprite onto the 
screen there are three things that need 
to be discussed. These are the 
DRAW SPRITE opcode, the sprite defi- 
nition block, and the sprite's background 
buffer. We will look at each of these struc- 
tures individually. 

The Line A opcode $A00D, 
DRAW_SPRITE, draws the desired sprite 
to the screen at the specified X/Y coor- 
dinates. To use this opcode the first thing 
you have to do is move the sprite's X coor- 
dinate into data register DO. Then, you 
have to move the sprite's Y coor- 
dinate into data register Dl. After setting 

continued on page 62 
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Merlin's Box is a single-player game in 
which you try to locate several glass 
spheres. The spheres are hidden within 
Merlin's Box and cannot be seen from the 
outside. Clues to where the spheres are 
located are obtained by shooting a light 
into the box and noting where it exits, if 
at all. When you believe you have located 
all the spheres, their correct locations will 
be revealed. Based on the number of cor- 
rect choices, you will be given a score 
from 0 to 100, 100 being the best. 

To create your copy of Merlin's Box 
from the program listings included here, 
you must first type and compile each list- 
ing. (Listing 1 requires Personal Pascal 
compiler and Listing 2 requires an assem- 
bler.) After compilation and assembly, you 
should have two files with a .O extension. 
Use the Personal Pascal linker to link 
these files. You will then have an execut- 
able .PRG file that can be run from the 
desktop. 

Playing the Game 

Merlin's Box is a low-resolution color 
game, so make sure you are in low- 
resolution mode. Double click on MER- 
LIN.PRG. When the title screen appears, 
click on the OK in the title box. Next, you 
will be asked to choose a skill level, 1 
through 3. In skill Level 1 you must locate 
three spheres, with Level 2 locate five 
spheres, and Level 3 locate seven spheres. 
Level 1 is pretty easy because there is less 
deflection from other spheres to confuse 
you. The seven spheres in Level 3 tend to 
bounce light around before it leaves the 
box, making for a few misjudgments as 
to the locations of the spheres. 

Once a level has been chosen, the 
spheres are randomly placed and the box 
is drawn. On each side of the box are 
eight positions from which to shoot light 
into the box. To shoot light click on one 
of these outside squares. A symbol will 
mark the entrance, and you will hear the 
light enter the box, bounce around and 
exit. 



When the light enters the box it can 
exit one of three ways. First, it can be 
deflected or go straight through, in which 
case a matching symbol will be displayed 
at its exit position. Second, it can exit 
where it entered. Here, a U-turn symbol 
will be placed. Last, the light can directly 
hit a sphere and be diffused throughout 
the box and not be strong enough to exit. 
In this last case a "Hit" symbol will ap- 
pear. Please refer to Figure 1 for an illus- 
tration as to how the light can act inside 
the box. One situation not yet mentioned 
is a Stall. Here the light is not able to 
enter the box because of an adjacent 
sphere. Stalls can be determined because 
no exit position is shown and neither a 
U-turn nor a hit is displayed. 

To guess where a sphere might be, click 
on one of the 64 squares in the box. A 
circle will appear marking your guess. If 
you wish to change your guess, click again 
on the circle, and it will disappear. You 
can then reposition your guess. In the 
lower left corner of the screen is the num- 
ber of spheres in the box. You must make 
a guess for all of them before obtaining 
your score. 

To get your score click on "SCORE" in 
the upper left of the screen. One by one 
the spheres will appear as either green or 
red. Green spheres mark a correct guess 
while red ones mark an incorrect guess. 
Your score will appear in the lower left 
of the screen. After a few games you will 
get the hang of it and then it will be time 
to move up a skill level. You can quit any 
time by clicking on "QUIT" in the lower 
right corner. Lastly, a hint. For those of 
you who are good listeners, try to listen 
to how and when the light deflects. The 
sounds come fast but can aid in locating 
tricky spheres. 

Brian J. Parry is a computer science student at 
the California State University, Chica He has pub- 
lished several programs for the Apple II and this 
is his first Atari ST program. 
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Merlin's Box — Listing 1 
Pascal C 

KMMKMMWMMMMWKMMMMMltMXHItllMMIIMMMMMltllllllMXXXMMMKXXMMXItMXIIXltMMMKMXKXItIt 



mm MERLIN'S BOX ** 

MM MM 

ww by Brian J. Parry Copyright (C) 7,1987 ** 

WW WW 

WW WW 

WW ww 



> 

progran MERLINS-BOX; 

const ($1 genconst) 

type ($1 gentype} 

var txtl, txt2, txt3 : string; 

n_box, n2_box : array [0..9, 0..9] of integer; 

la : array [lit 4,1.. 81 of integer; 

count, pattern, button, guess_nun, 

i, j, dir,nsx,nsy, skill-level, dunny : integer; 

nsg : nessage_buf f erJ 

quit, new_gane : boolean; 

desk-colors : array CO.. 151 of integer; 

{$1 getisubs) 
{WPEW> 

procedure DELAY (t: integer); 

var i, j : integer; 

begin 

for i:=l to t do 

for j:=l to 1000 do begin end; 

end; 

function LOGICAL-BASE : long-integer; 
xbios (3) ; 

function RANDOM : long-integer; 
xbios (17); 

function GET-RES : integer; 
xbios (4) ; 

function s.color (cn, cl '■ integer) : integer; 
xbios (7) ; 

procedure STDRU (screen_adr : long-integer; shape.nun : integer); 
external ; 

function CALC-SCRN-ADR (x, y '• integer) : long-integer; 
begin 

calc_scrn_adr :=logical_base+y*16B*18+x«16+16e8; 

end; 

procedure DRAM-SHAPE (x, y, sn : integer); 
begin 

stdrw(calc_scrn_adr(x,y), sn-1) ; 

end; 

function GIA-READ (d, ri integer) '• integer; 
xbios (28) ; 

procedure GIA-MRITE (d, r". integer) I 
xbios (28) ; 

<wPEw> 

procedure DO-SOUND (pitch, tine: integer) ; 

var state : integer; 

begin 

state:=gia_read(8, 7) ; 
gia_wr ite (state* ("»7), 135) ; 
gia_wr ite (15, 136) ; 
gia_wr ite (pitch&$FF, 128) ; 
gia_write(shr (pitch, 8), 129) ; 
delay (tine) ; 
statei=gia_read(0, 7) ; 
gia_write(state|7, 135) ; 

end; 

procedure INIT-PALETTE; 
begin 

set-color (0, 0000, 8000, 0000) ; 
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stt-coior ci, ieee, ieee, ieee) ; 

set-color (2, 1888, 8888, 8868) ; 
set-color C3, 8888, 1888, 8888) ; 
set-color C4, 8888, 8888, 1888) ; 
set_color (5, 1888, 1888, 8888) ; 
stt-coior (6, 8888, 1888, 1888) ; 
set-color (7, 1888, 8888, 1888) ; 
set-color (8, 8888, 8588, 1888) ; 
set-color (9, 8888, 8125, 8375) ; 
stt_color (18, 8625, 8625, 8888) ; 
set-color (11, 8888, 8625, 8625) I 
set-color (12, 8258, 8125, 8888) ; 
set-color (13, 8588, 8888, 8866) ; 
set-color (14, 8588, 8258, 8686) I 
set-color (15, 6625, 8375, 8668) ; 

end; 
{*PE*> 

procedure DRAM-BOARD; 
var i, j > integer; 
begin 

for it si to 8 do 
for j 1=1 to 8 do 
begin 

draw-shape (i,j,26); 
n-box[i, j] :=6; 
n2_boxCi, jl :=8; 
do-sound (588, 1) ; 
delay (1); 

end; 

for i : =1 to 8 do 
begin 

draw-shape (6, i, 27) ; n_box[8, i] :=1; n2_box (8, i) :=1; 
draw-shape (9, i, 27) ; n_box[9, i) :=U n2_box [9, i) :=1; 
draw-shape (i, 6, 27) ; n_box Ci, 8) : =1; n2_box[i, 8) :=1; 
draw-shape (i, 9, 27) ; n_boxd, 91 :=l; n2_boxd, 91 :=1; 

end; 

n-boxCS, 9] 1=11 
n-boxie, 81 >=l; 
n-box[9, 9) >=l; 
n_boxC9, 8) >=ll 
draw-shape (8, 8, 5) ; 
draw-shape (9, 9, 8) ; 

end; 

procedure PLACE-BALLS; 
var i,j,x, y : integer; 
begin 

for i:=l to skill-level do 
begin 

repeat 

xs=int (randon nod 18); 

g:=int(randon nod 18); 
until ((x>8) and (x<9)) and ((y>8) and (y<9)) and (n.boxtx, yl=B) ; 
n_box[x, yl : =-99 ; 
do-sound (288+75»i, 4) ; 
delay (7); 

end; 

end; 
<»PE»> 

procedure init_logic; 
begin 

(1 -> > 

lad, 11 i=l; lad,21:=8; lad, 3] s si; lad, 41:=-1; lad, 51 :=1; 
lad,61i=l; lad, 71 1=3; lad,8):=4; 

t2 <- > 

la[2,ll:=-l; laC2,2l!=8; la(2,3):=-l; la[2,4):=-l; la[2,5]:=-l; 
la[2,6H=l; la (2, 71: =3; la[2,81:=4; 

(3 v > 

la[3,l)<=8; la(3,2)i=l; la(3,3):=-l; la[3,4l:=l; la[3,5):=l; 
la[3,6)>=l; laE3,7):=l; la(3,8):=2; 

t4 A > 

la[4,l]:=8; la(4,2):=-l; la(4,3]:=-l; laC4, 41:=-l; la[4, 51:=1; 
la(4, 61:=-l; la(4,7]i=l; la(4,8):=2; 

end; 

function GET-SKILL : integer; 
begin 

button :=do_alert(' 121 1 Choose skill level 1(1 | 2 | 3 1 M) ; 
get-ski 1 1 1 =button*2+l ; 

end; 
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MIDIMON provides a detailed, easy-to-understand analysis of the MIDI data out- \yy LaiTV Herzberg 
put from any synthesizer, drum machine, sequencer or similar controller. A necessi- 
ty for MIDI programmers, a problem-solver for musicians, MIDIMON is also a fun 
and friendly program for anyone caring to unravel the mysteries of MIDI. Due to 
this program's large size, it's available only on this month's disk version or on the 
ST-Log SIG on Delphi. 



A few words about MIDI 

Have you ever wondered what was real- 
ly coming out of the MIDI port of your 
synthesizer, drum machine or sequencer? 
Although in recent years there has been 
a great deal of progress in standardizing 
MIDI (which, in case you don't know by 
now, is an acronym for Musical Instru- 
ment Digital Interface), there are still 
wide gaps in the transmission and recep- 
tion capabilities of various instruments. 
For instance, some synthesizers read "af- 
tertouch" information — the changes in 
key pressure after a note has been 
triggered — while others don't. And some 
transmit variations in velocity data — just 
how quickly (or hard) a note has been 
hit — while others can't. 

Sometimes such incompatibilities cre- 
ate performance problems for musicians 
who need to play several synthesizers with 
one physical keyboard. As a matter of fact, 
many synthesizers today have no keyboard 
of their own, and can only be played via 
MIDI, either from a "remote" keyboard 
or some other external controlling device 
(sequencer, MIDI guitar, MIDI drum pad 
or MIDI wind instrument; the list just 
keeps on growing). It can often be useful 
to determine which controls on the con- 
trolling device output MIDI data and 
which don't, and when they do, what con- 
troller numbers they have been assigned. 
Then, if the receiving synthesizers are 
flexible enough, they can be configured 
accordingly. 

There are basically three types of MIDI 
information: Channel, System Common/ 
Real Time and System Exclusive. Channel 
messages include note-on, note-off, con- 



trol change, program change, pitch wheel, 
poly key pressure and channel pressure. 
Let's take a closer look at these kinds of 
messages and see how MIDIMON can be 
helpful in clearing up some of the more 
common problems associated with them 

Note-on and note-off messages both in 
elude velocity data, but many synthesiz 
ers don't transmit note-off messages at all 
Instead, they turn a note off by transmit 
ting a note-on message with zero ve- 
locity. This doesn't matter in most 
cases, but if you're trying to play a 
sound on a synthesizer sensitive to 
release velocity from a controller 
which doesn't transmit actual note- 
off commands (with their added 
capability of variable release velo- 
cities), you're not going to hear all 
the expressive possibilities 
programmed into the last part of 
the sound. MIDIMON can quickly 
alert you to this problem. 

Control changes include events 
associated with levers, sliders, pedals 
and buttons. Sometimes controls 
will surprise you. I have an older 
Yamaha DX-7 which I use as my 
main keyboard. It would be handy 
if its volume pedal output some 
kind of controller information, but 
I've discovered with MIDIMON that 
it does not output MIDI data of any 
sort. On the other hand, the "YES" 
and "NO" buttons have been 
assigned MIDI controller numbers of 
their own (#96 and #97, both outputting 
a value of 127 when pressed). Although 
this might be useful when programming 
other Yamaha synths from the DX-7, it is 



MIDIMON is 
a fun and 
friendly 
program 
for anyone 
caring to 
unravel the 
mysteries 
of MIDI. 
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of limited utility when dealing with differ- 
ent brands of synthesizers. 

Patch changes often yield unexpected 
results as well. For instance, when I press 
patch button #1 on my DX-7, it outputs 
a patch #0 message through MIDI. In 
other words, it's "off by one" (as far as 
MIDI is concerned) throughout its entire 
patch range. Other synths, with multiple 
banks of sounds, sometimes assign non- 
consecutive patch numbers to adjacent 
banks. Fortunately, MIDIMON can help 



you map the patch layout of each of your 
synths so you can coordinate patch 
changes efficiently. 

Pitch wheel data is different from other 
controller data in that its center (no- 
effect) position should have a decimal 
value of 8192. Going sharp increases this 
value, while going flat decreases it. Check 
your pitch wheel with MIDIMON to make 
sure it conforms to this MIDI standard. 
You can tell by looking at the last value 
the pitch wheel outputs as it returns to 



its home position. 

Poly key pressure and channel pressure 
are two ways of transmitting aftertouch in- 
formation. The difference is that poly key 
pressure transmits separate values for 
each note played, whereas channel pres- 
sure does not. MIDIMON will tell you 
which kind of aftertouch your synth 
outputs. 

Finally, Channel Mode Select 
messages — Omni on and off, Poly and 
Mono — all concern the relationship be- 




Illustration by Brent Watts 



tween MIDI'S 16 channels and the syn- 
thesizer's voice assignments. When Omni 
is on, for instance, the synth can receive 
messages over any channel, rather than 
just its basic channel (which can usually 
be set by the user). The way in which Poly 
and Mono interact with Omni gets a lit- 
tle complicated, and depends in part 
upon whether the synth is transmitting or 
receiving; we'll leave such details to 
another article. What you should know, 
however, is that these messages, along with 
Local Control on and off, are handled as 
control changes by MIDI; that is, they do 
not have separate status bytes of their own 
(see below), but instead are identified by 
control numbers 122 thru 127. MIDIMON 
identifies all control changes by their as- 
signed controller numbers and specifies 
the values they are outputting, but iden- 
tifies these special Channel Mode Select 
messages by their "proper" names as well. 

The second category of MIDI informa- 
tion, System Common/Real Time, differs 
from Channel in one important respect. 
Whereas Channel messages affect only 
those instruments set to a particular chan- 
nel (or to all channels when Omni is on), 
a System Common / System Real Time 
message affects all instruments in the sys- 
tem capable of responding to it, regard- 
less of their channel or mode setting. 
Song position pointer, song select and 
tune request are all System Common mes- 
sages, while timing clock, start, continue, 
stop, active sensing and system reset are 
System Real Time. Timing clock is 
output by most drum machines 
and some sequencers to syn 
chronize output. Active 
sensing is simply 



a byte (hex FE) which is output every 300 
milliseconds by some synthesizers when 
nothing else is happening. Over the years, 
active sensing has been found to be of 
limited utility, and has now been dropped 
from many instruments. MIDIMON filters 
out active sensing bytes by default, but al- 
lows you to turn the filter off. 

There are two other messages that can 
be properly thought of as System Com- 
mon, but which really function only as 
"bookends" for the third category of 
MIDI information: System Exclusive. 
Although there is no standardization of 
System Exclusive data, it is always head- 
ed by an $F0 byte and tailed by an $F7 
(End Of Exclusive) byte. In between can 
be any number of data bytes, but the first 
byte after $F0 should always contain the 
manufacturer's ID number. This ID num- 
ber is what allows you to single out a par- 
ticular instrument in a chain for System 
Exclusive operations ($F0 and $F7 being 
channel-independent messages). On a 
synthesizer, System Exclusive data usual- 
ly includes the values the instrument as- 
signs to its internal components in order 
to produce a given sound. This is how syn- 
thesizers of the same make (or model) can 
send and receive patches or whole banks 
of patches; not just the patch numbers, 
but the actual sounds themselves. 
On a drum machine, System Exclu- 
sive data generally in- 
cludes the 



coding by which it remembers patterns or 
songs. MIDIMON accepts System Exclu- 
sive data, and properly identifies it as 
such, but to analyze all the data in detail 
it is necessary to consult your particular 
instrument's System Exclusive specifi- 
cations. 

MIDI data formats 

In its simplest form, MIDI data is out- 
put in packets of one, two or three bytes. 
It's most easily readable in hexadecimal 
form, each byte consisting of two hex 
digits. Any byte with a value greater than 
or equal to $80 (128 in decimal) is called 
a "status" byte. Status bytes identify the 
type of operation which the instrument 
is being called on to perform. For exam- 
ple, when a synthesizer receives the value 
$90 through its MIDI-In port, it recog- 
nizes this value as a note-on command for 
all synths set to receive information on 
channel #1 (the second nibble of the sta- 
tus byte in a Channel message is always 
the channel number minus one; this con- 
vention limits MIDI to 16 channels). 
However, it does not yet know which note 
to turn on or how loudly to play it. The 
following two bytes — known as data 
bytes — give it this information in values 
ranging from $00 to $7F (0 to 127). The 
second byte of the packet is the note num- 
ber, the third its velocity (loudness). Pro- 
gram change and channel pressure 
messages are transmitted 




in packets of only 
two bytes, while most 
System Common / Real Time 
messages need only one byte to get their 
points across. I'm not going to go into 
much detail on this subject; there's plenty 
of information available if you wish to 
delve further into the mechanics of MIDI, 
and you'll be able to learn almost every- 
thing you need to know just by observing 
how MIDIMON interprets MIDI output. 
The important thing to understand here 
is that the meaning of data bytes depends 
entirely upon the status byte which pre- 
cedes them. 

So far so simple, right? Well, not quite. 
Suppose you play a couple of notes into 
MKiWAON. When you look at the MIDI- 
MON analysis screen, on the far left side 
where the raw data is listed you might see 
a series of 3-byte packets, but you might 
also see one 3-byte packet followed by a 



bunch of 2-byte packets. Don't let that 
throw you; it only means that your syn- 
thesizer outputs MIDI data in the "run- 
ning status" format. This means that once 
a status byte is output, it need not be out- 
put again as long as the same kind of 
MIDI event follows. This is a faster, more 
efficient way of transmitting MIDI data, 
and seems to be gaining in popularity. 
Some instruments use a combination of 
standard / running status formats. In any 
case, all instruments should be able to cor- 
rectly interpret both. 

Using MIDIMON 

Make sure your computer's MIDI-In is 
connected to the synthesizer's MIDI-Out, 
and vice-versa. Turn the synthesizer on 
first, then run MIDIMON off the desktop 
like you would any other program. After 
the title is displayed you'll be asked 
whether you want to filter out active sens- 
ing bytes or not. Unless you have some 
reason for wanting to see them, I recom- 
mend that you do filter them out. Now 
you're in capture mode; as soon as you 
play a note or fiddle with any MIDI- 
transmitting controller, it will show up on 
the capture screen. Although the capture 
screen clears after you fill it up each time, 
don't worry about losing the data; it's all 
being stored in a buffer as large as the 
free memory in your computer. 

All the functions available from capture 
mode are listed on the menu line at the 
bottom of the screen. When you want 
to enter analysis mode, simply hit 
"A." An analysis will then be 
printed to the screen, and the 
menu line will show you 
which keys to press in order 
to page back and forth 
through the analyzed data, 
return to capture mode or quit. 
The analysis includes the raw data in hex- 
adecimal form, packet by packet, a 
description of each status byte, channel 
number if appropriate, and whatever de- 
tails are relevant. If you return to capture 
mode, the buffer will remain intact unless 
you formally clear it with the "Clear Cap- 
ture command. 

Do you want to print the analysis to a 
printer or disk file? Just strike "P,"and you 
will be prompted as to which device to 
print to. Printouts to the printer can be 
aborted by striking "A" at any time. 

In order to send a string of bytes to the 
synthesizer, press "S."You can then enter 
a series of up to 32 bytes (64 hex nibbles) 
in hexadecimal form. Any characters other 
than hex digits (except spaces) will not be 
accepted, and since it takes two hex digits 



to make a byte, odd numbers of hex digits 
will not be transmitted. Spaces are not 
transmitted, but are counted as characters 
in the send buffer. 

Here's an example. To turn on middle 
"C" (note #60, decimal) with a velocity 
value of 64 (decimal), you would enter: 
90 3C 40 

To turn it off, you could use the note-on, 
zero-velocity method by sending: 
90 3C 00 

Alternately, you could send a formal note- 
off (a status byte of $80 on Channel I) and 
experiment with a release velocity of, say, 
32 (decimal): 

80 3C 20 

Or if you wanted to see how your synth 
reacts to "running status," you might try 
turning off the note with no immediate 
status byte at all: 

3C 00 

It's probably a good idea to first learn how 
your synthesizer handles MIDI by analyz- 
ing some of its output. Then you'll know 
the best way to communicate with it. In 
regards to sending your synthesizer System 
Exclusive commands, remember that you 
must preface all such messages with an 
$F0 byte followed by the manufacturer's 
System Exclusive ID number. If you initi- 
ate a patch dump from the synthesizer it- 
self, MIDIMON will analyze this ID 
number for you. The model ID number 
is also necessary sometimes, as is an $F7 
at the end of the command. 

A note about MIDIMON's Echo feature 
You can toggle this function on and off by 
pressing "E" in capture mode. When you 
press it the screen will clear, and the let- 
ter next to "E"cho on the menu line will 
switch from "N" to "Y" or back again. "N" 
means no echo; "Y" means, yes, the echo 
feature is on. While it is on, everything en- 
tering the computer's MIDI-In port is im- 
mediately echoed to its MIDI-Out port. 
This acts like a simple Thru box, and can 
be quite handy for checking synthesizer 
compatibilities while monitoring input. 
Remember, however, that if the synth you 
are playing is also receiving data from the 
computer's MIDI-Out port (along with the 
synth you intend to echo to), notes on the 
transmitting synth will be triggered twice, 
once from the keyboard and again from 
the computer. This can create strange, "out 
of phase" sounding effects. There is an 
easy way to remedy this problem, however. 
Reconfigure the keyboard to receive on a 
different channel than it's transmitting on. 

Larry Herzberg is a freelance musician, writer 
and MIDI programmer who has been based in 
Los Angeles for the last ten years. 
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UTILITY 



by Matthew J. W. Ratcliff 



Altered STeights is a graphics dis- 
play utility for ST owners like 
me, who still have a particular 
affection for the old reliable 8-bit 
machines. Altered STeights will load and 
display Koala pictures, 8-bit graphics 
mode 9 and mode 8 screens as well. If you 
have Computer Eyes for your 800XL, why 
buy a new version for the ST? Just 
port your pictures over to big brother and 
load them up with Altered Sleights (more 
on "porting" later). You can load pictures 
in quarter- (four Koala pictures on the ST 
display at once), half- or full-screen for- 
mats. It is more than a picture viewer util- 
ity however, since it allows you to save your 
composite creations in DEGAS uncom- 
pressed f ormat. Note that due to the large 
size of the source code, this program (and 
all associated files) is found only on this 
month's disk version or on the Delphi ST 
SIG. 

When you double click on 
ALTSTE.PRG, the program will run and 
a brief demonstration will be presented. 
You must be in low or high resolution to 
run this program. The demo gives you a 
quick preview of just what this utility is 
designed to do. Three demo files are 
searched for, DEMO with an extender for 
each 8-bit screen type, .PI9, .PI8 and .PIC 
respectively. If found each is loaded and 
displayed. In monochrome, the picture is 
mapped to the display in all seven possi- 
ble display combinations. In color mode, 



Altered STeights uses VDI plot calls in- 
stead of direct screen-memory writing, so 
it is much slower. The low-resolution 
demo loads the .PI9 file and displays it 
in "split" screen format, on the left of the 
display. The .PI8 and .PIC demonstrations 
are shown on the right half of the display 
in "quad" format, top and bottom. The 
mode 9 pictures, digitized photos and 
such, look best in low resolution, while 
the mode 8 and Koala pictures look bet- 
ter in high. If you will be using this utili- 
ty to create "clip art" files for Publishing 
Partner, for example, then it is best to 
work in high resolution if possible. 

After the demo, the first dialog (or 
more accurately, form alert) is presented, 
giving you the option to continue or exit. 
You are next prompted to clear the work- 
screen before continuing. The first time 
through you'll want to answer YES, unless 
you would like to continue looking at the 
last demo screen while loading other 
pictures. 

The next dialog prompts you for the 
picture type you're going to want to load: 
mode 9, mode 8 or Koala. The extenders 
for these pictures are expected to be .PI9, 
.PI8 and .PIC, respectively. Once you 
select the picture type, if you load a differ- 
ent type of picture, the display is likely to 
look a bit odd. If a Koala load is request- 
ed, the file will be uncompressed from 
the Micro Illustrator format if necessary. 
If it's a simple screen dump, or a "head- 



er error" occurs, it's mapped to the screen 
verbatim. (If it goofs up the display, you 
can always load another picture over it.) 

Once you select the picture type, a file 
selector is brought up with a directory of 
the current drive, path and the proper ex- 
tender expected. Double click on the file 
(or once and OK) you wish to load, or 
cancel if you want to do something else. 

If you are in the full-screen format, the 
picture is mapped to the display immedi- 
ately. If you had selected half screen, you 
will be prompted to point and click on 
t he side of the screen to map the picture 
on. Similarly, if you're in the "quad" for- 
mat, the display will be divided into quart- 
ers, so you can point and click on the 
proper quadrant. 

After the picture is on the display, click 
the left mouse button to continue or the 
right button to "invert" the picture. Most 
mode 8 pictures, for example, will look 
fine in a black-on-white display format. 
This includes screen dumps from Solid 
States or Super 3D Plotter II. If the pic- 
ture loaded was a mode 8 Computer Eyes 
picture it will look like a "negative." Click- 
ing the right mouse button will correct 
for this. 

Continuing after the load will bring up 
another alert box with the following 
prompts: 

AGAIN — Load another picture of any 
of the three types supported in the same 
screen layout format. 
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SAVE — Bring up a file selector, with the 
extension of .PI3 or .PI1, to save the cur- 
rent display screen as a DEGAS uncom- 
pressed picture file. 

RESTART— Restart the program, then 
exit or continue. Continuing allows you 
to clear the screen and select a new screen 
format. 

You can create some interesting com- 
posite pictures this way. For example, you 
can load two pictures in quad-screen for- 
mat on the left side of the display. Then 
restart and select half screen to load a pic- 
ture on the right side of the display, 
without clearing the screen first. You can 
freely load and display mode 8, 9 and 
Koala pictures on the same display. 

If the Koala pictures are in the Micro- 
Illustrator compressed format, Altered 
STeights looks at the color data in the file. 
It then generates a look-up table based on 
the luminance values for each of the fore- 
ground colors. The end result is proper 
shading in your Koala pictures. If the lu- 
minance values are the same, then a 
default look-up table (LUT) is generated. 
Sometimes your Koala pictures will need 
to be inverted because of this. You can al- 
ways go to DEGAS and adjust colors of 
any picture you've saved in color mode. 

The 8-bit GRAPHICS 9 pictures are 



made up of 80x192 pixel, 16-gray- level 
data. Altered STeights emulates this with 
an 8x2 pixel grid of varying dot densities. 
In the quarter-screen format you lose 
50% of the original picture's horizontal 
and vertical resolution. To compensate, I 
tried averaging four pixels of the original 
data for every 8x2 block on the ST's dis- 
play, but the end result was a little washed 
out and fuzzy. Altered STeights just toss- 
es out what won't fit, and most pictures 
look pretty good anyway. 

In the split-screen format, 50% of the 
horizontal resolution must be sacrificed. 
Several different shading patterns are 
used for the Koala pictures to retain 
100% of its resolution in all screen for- 
mats. For the mode 8 pictures, no shad- 
ing is required, and there's no loss of 
resolution — even in the quad-screen for- 
mat. In low resolution you'll lose some im- 
age data in quad-screen formats for mode 
8 and Koala pictures. 

If you still have a complete 8-bit system, 
you may want to transport your graphic 
files from it to the ST. The easiest way to 
do this is with a "null modem" cable and 
terminal software at both ends. I use Flash 
on the ST and Keith Ledbetter's Express 
3.0 at 2400 baud, both in ASCII mode, 
half duplex, 8 bits per character and one 



stop bit. Once cabled up, I set up the 8-bit 
to send Xmodem. Next the ST is set to 
Receive Xmodem and I start the transfer. 
The rest is automatic. If you have the 8-bit 
ARC utility, it'll save a lot of time if you 
compress all of your pictures into one big 
file and get the job done in one transfer. 
Then just de-ARC them on the ST. 

Figure 1 is a schematic for the 8-bit to 
ST null modem cable. A 9-pin D type 
male connector is needed for your P:R: 
Connection or 850 interface. A 25-pin D 
type female (RS232) connector is needed 
for the ST. It isn't absolutely necessary to 
carry DTR through to CRX (this is just 
used by the computers to make sure the 
other is ON). You can simply short pin 
1 to 2 on the 9-pin 8-bit connector and 
pin 20 to 8 on the 25-pin ST connector. 

Of course, you can always download 
Koala pictures from Delphi or most any 
public Atari BBS. In the Atari SIG on Del- 
phi we have a Koala database. You can 
also find many Koala and digitized pic- 
tures in the Micro Artists SIG. 

The program was developed with 
Megamax C and the ever-patient as- 
sistance of Charles F. Johnson, Dan 
Moore, Tim and Jeff Randall of Randall's 
Home Computers and Clay Walnum's C- 
manship series. My thanks to them all! 
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STPlus»STPlus»STPlus»STPlus 

P.O. 1197, Berkeley, Ca. 94701 

We all want the ST to grow, so let's BUY MORE SOFTWARE so the ST grows! 



BUSINESS 



DBMan 4.0 175.00 

Datamanager 56.00 

Superbase 104.95 

Trimbase 69.95 

Phasar 63.95 

Zoomracks 2 84.95 

Base 2 42.95 

The Informer 69.95 

WordPerfect 189.95 

1st Word Plus 69.95 

Word Upl 64.95 

Best Accounting 279.95 

Equal Plus 139.95 

Inventory Mgr. 69.95 

Rolobase Plus 63.95 

Loglstix Spread 104.95 

Microlawyer 49.95 

Payroll Master 69.95 

Construction EST. 35.00 

Microsoft Write 94.95 

Datatrieve 35.00 

STOneWrite 48.95 

VIP GEM 104.95 

DacEasy Payroll 48.00 

DacEasy Acctg 52.00 

WordWriter ST 56.00 

SwiftCalc 56.00 

EZ Calc by Royal 48.95 

Analyze Spread 25.95 

Final Word 99.95 

PublishingPartner 140.00 

T-works Publish It 89.95 

EZData Base 48.95 

Chart Pak 35.00 

Compute Roots 27.95 

Thunder NEWI 28.95 

Habawriter 2 48.95 

Text Pro 35.00 

Becker Text 62.95 

Expert Opinion Al 59.95 

Time Link 35.00 

Partner ST 48.95 

Labelmaster Elite 35.00 

ST Accounts 149.00 

The Juggler 35.00 

Max Pack 35.00 

Stuff 27.95 

Flash 1.5 21.00 

accting ea. 275.00 

Omni Res 27.95 

Turbo ST(-blitter) 35.00 

Dollars & Sense 69.95 

ONE NEW NUMBER 
We ship ANYWHERE! $4.00 



GRAPHICS 



Degas Elite 55.95 

CAD 3D 2.0 63.95 

Cyber Paint 49.00 

Quantum 4096 27.95 

Adv Art Studio 26.00 

Spectrum 512 49.00 

EzDraw&Superch 104.95 

Canon Scanner 1040.0 

GFA Artist lOOOd 55.95 

Drafix 1 139.95 

Athena 2 69.95 



GAMES 



Gunship 
Shadowgate 
Uninvited 
Mouse Quest 
Slaygon 
Barbarian 
Obi iterator 
Guantlet 
Dark Castle 
F- 15 Strike Eagle 
Star Trek- Rebel U. 



How would you like to be an 

ST dealer? If you are 
interested, I am looking for a 
few limited partners to work 
with in areas which lack ST 

support. This is not a 
solicitation by Atari nor to 
circumvent Atari's network 
but an invitation to work with 
an established dealer to set 
up new dealerships. I am 
especially interested in college 

and business areas. 
Call (415)841-9183 to discuss 



MUSIC 



35.00 Tassvort 
35.00 Master Tracks 
35.00 MasterTracks Jr. 
14.00 Midisoft Studio 

JJ'JJ hybrid Arts 
27 95 Smpte Track 
27.95 sync Track 
35.00 EZ Track p| us 
27.95 Midiscore 
27 95 EZ Score Plus 
27.95 DX-Android 
CZ-Android 
Gen- Patch 

Dr. T's 

KCSequencer 
KCS 1,6 w/PVG 
MIDI rec studio 
Copyist level 1 
Copyist level 2 
Copy 3- Postscript 



HARD 


m 


SK 


S 



PROGRAMM1N 



GFA Basic 
GFA Book 
GFA Compiler 
Mark Williams "C" 
Laser "C" 
Cambridge Lisp 
RAID 

Fast Editor 
Alice Pascal 
OSS Pascal 
Fortran 77 GEM 
BCPL 

Modula 2 dev. kit 
Assempro 
Fast Basic 
True Basic 

Arakis Series 
Unicorn Series 
True Basic Stuff 



56.00 
35.00 



GAMES 



Tanglewood 
Test Drive 
loc'nn Chessmastr2000 
StarGliderbw&cl 
Hunt for Red Oct 
Police Quest 
Aliants 
Alien Fire 
Santa Paravia 



20 Meg Supra 
20 Meg w/ clock 
30 Meg Supra 
60 meg Supra 
33 Meg UnderMtr 
51 Meg UnderMtr 
60 Meg BMS RRL 
20 Meg SH205 
250 Meg 



159.95 
139.95 
27.95 
35.00 
69.95 
59.95 



European 



139 95 Lurkin9 HOITOr 
IZ.ZZ Star Fleet 1 



104.95 
104.95 
48.95 
56.95 
69.95 

14.00 



Empire 

Liesure Suit Larry 
Gridiron 

Dungeon Master 
Flight Simulator 
Trailblazer 



27.95 
35.00 
32.95 
32.95 
35.00 

24 95 I Ball (neatfast) 
35 00 R 00 ^ 0 ™ 0 ^^) 
21 00 War,ocks Q uest 
2j'qc The Flintstones 

39 95 Trivial Pursu ^ 

39 95 The Enforcer 
27 9 Seconds Out 

35 00 Scruples(board) 
07 o=i Livingstone 
2g QQ Battle Ships 

27 95 Outrun(fast cars) 
Crazy Cars 



]9 95 Tetris (from USSR) 
19 95 Screaming Wings 



280.00 
104.95 
69.95 

499.95 
299.95 

48.95 
call 
104.95 
139.95 

69.95 
104.95 

199.95 
289.95 
56.00 
75.95 
139.95 
299.95 



■•SPECIALS'-- 
ao Jewel of Darknss 
69.95p silicon Dreams 

800-759-1 1 10 Prices subject to change without 

mln S&H. No 1040's or Megas mail order. Hand delivery only, List 

CIRCLE #107 ON READER SERVICE CARD. 



558.00 
599.95 
749.95 
1249.95 
699.95 
839.95 
1039.00 
639.95 
3250.0 



19.95 
29.95 
29.95 
29.95 
29.95 

19.95 
29.95 
29.95 
29.95 
29.95 
29.95 
29.95 
29.95 
29.95 

notice, 
plus $100. 



by Gordon Billingsley 



GEMKIT is a set of ST, BASIC subroutines that gives you easy access to the pow- 
er of the ST Graphics Environment Manager. GEMKIT uses simple, one-word 
GOSUB calls to manipulate graphics and text, create dialog boxes, use the mouse 
and perform many other functions with the lightning fast speed we all expected 
of the ST. All of the features work in any screen resolution. 

Since GEMKIT is intended for use in all resolutions, some GEM features that 
work only for color monitors are not included. Also, because ST BASIC is, itself, 
a GEM application many GEM features that duplicate BASIC statements and func- 
tions are not included. Often BASIC statements already are making direct GEM 
system calls. 

In other ways, GEMKIT expands on what GEM has to offer. For example: 

1) GEMKIT uses an algorithm not available in GEM to automatically center lines 
of text in any of four type sizes ranging up to twice normal size; 

2) GEMKIT contains an algorithm to automatically assign individual characters 
in a text string to an array allowing pixel-accurate placement of the whole string. 
(Without the algorithm you'd have have to put the text string on the screen essen- 
tially one letter at a time.) 

Listing 1 contains not only GEMKIT itself (Lines 60000 on), but also a short 
program that demonstrates its features. To use GEMKIT in your own programs, 
delete Lines 10-410 (the demo program) in Listing 1. 

Reading the mouse 

GOSUB READMOUSE tells you where the mouse pointer is located and whether 
one of the mouse buttons has been pressed. The x- and y-coordinates (mx, my) are 
returned as pixel locations on the screen. 

Mouse button presses may be detected in a variable called button, with values 
as follows: 0=no button pressed; 1 = left button pressed; 2 = right button pressed. 

Here's a program example that calls the subroutine to read the mouse status 
and then checks for the x-coordinate location of the pointer and the status of the 
right button: 

10 GOSUB READMOUSE 

20 if mx>150 and button =2 then 40 

30 goto 10 

40 REM program continues here 

Pointer shapes 

Each of the following routines automatically changes the form of the mouse 
pointer to the shape the name of the subroutine implies: 

GOSUB ARROW: the default pointer 

GOSUB BEAM: an I-beam shape useful in word processing 
GOSUB BEE: the famous busy bumblebee 
GOSUB FINGER: a hand with a pointing finger 
GOSUB HAND: the back of a hand or grabbing hand 
GOSUB CROSSHAIR: a thin-line version of the crosshair 
GOSUB FATHAIR: a thickened version of the crosshair 
GOSUB HOLLOWHAIR: an outline version of the crosshair 

Pointer visibility 

GOSUB HIDE allows you to make the pointer invisible at any time you want 
to ensure it does not appear on the screen. GOSUB SHOW allows you to ensure 
that the pointer is visible at all times it is needed. 

Text manipulation 

Each of the following routines automatically changes the typeface as it appears 
on the screen to the form implied in the subroutine name. A change in type style 
remains in effect until explicitly changed again. 
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GOSUB NORMAL: system default 
typeface 

GOSUB BOLD: a thickened version of 
the default face 

GOSUB HATCH: a hatched look, some- 
times called ghost letters 

GOSUB ITALICS: a skewed face 

GOSUB UNDERLINE: underlines the 
system default face 

GOSUB OUTLINE: a hollow typeface 

Calling a type-style subroutine does not 
affect type styles of characters already on 
the screen. 

Adventurous programmers may use 
GOSUB NEWFACE to create faces that 
are combinations of the six standard 
faces. For instance, it is possible for a type- 
face to be both bold and italic at the same 
time. To do this you assign an appropri- 
ate value to a variable called font, then call 
GOSUB NEWFACE. 

Each type style has a unique number 
value as below: 



Normal = 0 
Hatch = 2 
Underline = 8 



Bold = 1 
Italics = 4 
Outline = 16 



To create a combined style, add the 
values for the styles you wish to have com- 
bined. Bold/italics would equal 5, for in- 
stance. This is the same method used to 
combine type styles in ST-Writer. 

As an example, the command sequence 
to set the type style to bold/ital- 
ic/underlined would be: 

10 font = 13:GOSUB NEWFACE 

Four type sizes are available in GEM- 
KIT for the creation of showy title and 
menu screens: small, regular, large and ex- 
tra large. A line of any size type may be 
placed on the screen with pixel accuracy 
by using the mnemonic GOSUB routines. 

GOSUB STYPE: small type, V4 system- 
default type size 

GOSUB RTYPE: regular type, system- 
default type size 

GOSUB LTYPE: large type, 1.5 times 
system-default type size 

GOSUB XLTYPE: extra large type, two 
times system-default size 

Each of these subroutines must be 
preceded by program lines to indicate the 




If you desire 

screen- 
centered text 
you should 
change the 

values 
assigned to 
the variable 
called rez, 
which can be 
found in the 

TYPESIZE 
subroutine. 




desired text string and to set xy pixel 
coordinates for placing the first letter of 
the text. The text string is set in a varia- 
ble called text$. The pixel locations are set 
with variables called tx and ty. For in- 
stance: 

10 text$ = "Hello World!" 
20 tx = 50:REM x-coordinate 
30 ty = 150:REM y-coordinate 
40 GOSUB XLTYPE 

When using any of the type-size subrou- 
tines, each single line of text must have 
its own pixel-precise coordinates and 
separate GOSUB call. You cannot use 
combinations of GOTOXY and PRINT to 
place nonstandard character sizes on the 
screen because PRINT does not space 
nonstandard letter sizes correctly. As 
much as half of each of the letters may 
disappear because of overlapping when 
PRINT is used. 

Of course, the standard or default type 
style, may be placed on the screen using 
PRINT statements, but it is not necessary 
in that instance to use GOSUB RTYPE. 
GOSUB RTYPE should be used only 
when you want pixel-accurate placement 
of the standard type size 

Text and graphics in ST BASIC are nor- 
mally limited to the output window. With 
GEMKIT placement routines, however, 
the entire screen is available. You could, 
for instance, place scoring information in 
the upper right corner of the screen, out- 
side the playing window of a game. 

BASIC views position 0,0 as being the 
upper left corner of the output window. 
GEM views position 0,0 as the upper left 
corner of the screen. You should be care- 
ful about obliterating menu bar items and 
such unless you really want to. 

A line of any size of text may be auto- 
matically centered in the BASIC output 
window. Simply assign the desired y- 
coordinate pixel position (vertical posi- 
tion) to the variable called ty, set the text 
string in the variable called text$ and call 
the appropriate centering subroutine. 

A subroutine is available for each of the 
four type sizes and each has been given 
a mnemonic name. You do not have to set 
the type size first. The centering routine 
automatically sets the type size and 
centers the line of text. It also adjusts the 
point at which it centers for any screen 
resolution. 

continued lo page 5S 
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TUTORIA 



Software 
Engineering: 

System Specification and Analysis 



by Karl Wiegers 



w 

W W hat's the first thing you think 
about when you decide to begin a new 
software project? I hope your answer is, 
"What's the intended output of this pro- 
gram?" The output of a program might 
be described very differently, depending 
on whether you're contemplating a 
weather-predicting program or a flashy 
arcade-style game. But all computer pro- 
grams produce some kind of output, and 
it helps immeasurably during the 
programming if you know exactly what 
that output is. 

In the olden days of computer pro- 
gramming, the issue of specifying precise- 
ly what a software system was to 
accomplish often was skirted, rather than 
being confronted head-on and beaten 
into submission. The results were predic- 
table:Systems were delivered to end users 
far behind schedule, they cost a lot more 
than anyone expected, and all too often 
their performance bore only a vague 
resemblance to what the end user really 
had in mind. "Don't worry about the de- 
tails now," the system analysts said. "This 
baby will be so flexible that we can change 
it later on when you decide what you real- 
ly want." The analysts were wrong; their 
customers were unhappy. 

Contemporary software development 
efforts rely more and more on systemat- 
ic "software engineering" methodologies. 
A vital aspect of those methodologies is 
a structured, comprehensive approach to 
analyzing the problem that the software 
system is being constructed to solve, 



thereby defining the system's intended 
functions. This is a critical first step, to be 
taken before any code is written if you 
truly wish to create a high-quality system. 
In fact, good specifications are fundamen- 
tal to any problem-solving venture, from 
building a box to keeping your firewood 
dry to landing a man on Mars. 

"But," you say, "I successfully 
programmed for years on an Atari 8-bit 
computer without using any of these new- 
fangled ideas." So did I. And when you're 
dealing with small memories and low- 
powered computers, you can get away 
with more casual development methods 
much of the time. But the new generation 
of microcomputers, such as the Atari STs 
and their big brothers of the Mega per- 
suasion, can run programs vastly larger 
than could be handled by the 8-bits. These 
programs often are written by teams of 
programmers, and they might involve 
dozens of program modules all spliced 
together to create the final product. A sys- 
tematic, structured approach can give 
tremendous improvements in productivi- 
ty, quality and reliability for such systems. 

Some software engineering gurus be- 
lieve that about 40% of the effort put into 
a complex software system should be 
devoted to defining the system through 
structured analysis and design activities. 
Only 20% of the time should be spent on 
the implementation step of actually writ- 
ing code, with the remaining 40% used 
to integrate the pieces of the system and 
test for proper behavior. In this article 



we'll begin a discussion of the software en- 
gineering process by examining the prin- 
ciples and tools of structured analysis and 
system specification. 

Where do I begin? 

Amazingly enough, at the beginning. 
Many programmers gloss over the begin- 
ning and dive right into a source code 
editor. Only later do they realize how 
much easier life would be if they had a 
plan, a design. I look at it this way: If I 
don't know what I'm trying to accomplish, 
how will I know when I'm done? 

Admittedly, a thorough, structured 
analysis isn't something most hobbyists 
want to spend their time on. They (includ- 
ing me) want to write code. And it's true 
that the problem of system specification 
is less serious when only one person (you) 
is working on the project. But believe me, 
if you read the rest of this article and try 
to apply some of the ideas to your next 
project, I think you'll recognize the 
benefits. Software engineering methodol- 
ogies can do for complete systems what 
structured programming methods do for 
individual program modules. The long- 
term payoff comes during the main- 
tenance phase of a software project, when 
you're trying to add additional features 
or eradicate bugs. A high-resolution road- 
map of your system makes navigation a 
whole lot easier. 

The goal of system analysis is to come 
up with a requirements document which 
will serve as the guiding beacon for the 
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rest of the development effort. In the old- of what the system will do. 

en days, these often belonged in the Vic- Now we must refine this idea into suc- 

torian novel category: huge, unwieldy and cessive levels of detail, such that we not 

incomprehensible. Nobody ever read the only gain a thorough understanding of 

whole thing. In the 1970s, though, new what we wish to accomplish, but also get 

methods were invented that use graphics enough information so that we can even- 

for much of the requirements document, tually write a program. Along the way, I 

The focus is on communication, and like to create a written, numbered list of 

we've all learned that visual communica- all the functions the system must perform, 

tion through graphics can be much more Then, as I design the system, I'm less likely 

effective than reading volumes of text. So, to overlook something inadvertently, 
modern requirements documents contain 

lots of pictures. How do you draw a pic- Model making 

ture of a software system? We'll see shortly. With the statement of purpose firmly 

Of course, it's unrealistic to expect that in mind, we want to begin building 

the system requirements will never "models" of our software system. These 

change once they're written down. Most models will graphically represent the sys- 

prqjects go through many iterations of tern at various levels of detail. An impor- 

refinement and enhancement. You prob- tant goal of building these models is to 

ably won't be able to permanently freeze break the system down into logical pieces 

the requirements, but the more you know that fit together so that there aren't any 

about the needs before you begin writing gaps when we assemble the final product, 

code, the better off you are. The idea, Come to think of it, this isn't all that 

then, is to construct the system such that different from building a plastic model 

it can readily accommodate changes of an F-15 jet fighter. Obviously, we don't 

without collapsing under its own weight, use molded plastic parts and glue for con- 

This is the goal of structured analysis (in structing models of software systems; we'll 

the early phases), structured design (in get to the model components in 

the middle stage), and structured just a bit. First let's think about 

programming (in the later phases). the different kinds of models we 

To explore some of the ideas and tech- might want to create, 
niques of structured analysis, let's use a During the analysis phase, you 
real example, an educational chemistry begin by building a "logical" 
game called Reaction Time that I wrote model of the system. This is a 
once upon a time on an 8-bit Atari in as- conceptual depiction of what the 
sembly language. In Reaction Time, a software system is supposed to 
player moves chemical formulas and do, showing its connections to 
numbers from specific areas on the the outside world (that is, every- 
screen into an empty line representing a thing in the universe that isn't a 
chemical equation. The idea is to build part of your system, yet which in- 
valid chemical reactions by properly com- teracts with it in some fashion), 
bining four elements or compounds from The logical model is indepen- 
a specified list of formulas. Each reaction dent of any implementation de- 
set contains 15 different formulas, and be- tails, showing just what happens 
tween nine and 16 valid equations can be and not how it happens, 
constructed in each set. The program has After creating a clear picture 
seven different reaction sets, representing of your system functions on a 
different aspects of basic chemistry. The logical basis, you build a "physi- 
player gets ten points for each correct cal" model of the system. (I don't 
equation and six points for each equation mean a physical model in the 
in which the formulas are correct but the sense of ice cream sticks and 
coefficients are not; he loses five points playing cards, but rather a 
for each incorrect equation. graphical model of the ultimate 
See? You just read the entire statement physical system you intend to 
of purpose for Reaction Time. And you create.) This physical model will 
didn't even have to know anything about include implementation details 
computers (and not much about chemis- such as hardware- and software- 
try). Notice that this description of the sys- specific features. An example 
tern didn't say anything at all about the might be a program that will use 
programming language that would be GEM on the Atari ST for the 
used, the kind of hardware the program user interface The same program written 
would run on, or any other details. We're for an IBM PC might have a rather differ- 
beginning with a fairly abstract statement ent physical model, because of the differ- 



In the olden 
days of 
computer 
programming, 
the issue of 
specifying 
precisely what a 
software system 
was to 

accomplish often 
was skirted, 
rather than 
being 
confronted 
head-on and 
beaten into 
submission. 
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ent user environments. However, these 
two physical models would be based on 
the same logical model, since the system 
functions would be the same in both 
cases. 

Actually, you may well build more than 
one physical model. After all, there's 
almost always more than one way to solve 
a particular problem. It's highly advisable 
to consider all the approaches you can 
think of early on, and then choose the 
one that makes the most sense. Also, this 
makes you feel much less foolish than if 
you dive right in and then discover a far 
better approach after you're neck-deep in 
design flaws. 

Sometimes (although not usually when 
writing for microcomputers) the system 
being developed represents an automa- 
tion of an existing system. For example, 
converting a process that is currently per- 
formed manually into one in which a 
computer performs all or part of the tasks 
of the process fits into this category. In 
cases like this, the proper starting point 
is to build a physical model of the current, 
manual process. This helps to identify all 
the functions and components of the cur- 
rent system, in terms of the documents, 
people, and equipment actually involved 
in the execution of the process. 

From that specific, physical model you 
can derive a logical model of the current 
system. The logical model is basically the 
physical model with the implementation 
details removed. Who needs to know that 
Ralph sorts the mail in room 145? All you 
need to know on a logical basis is that the 
mail gets sorted. Then, the logical model 
of the current system can be used as the 
starting point to generate the logical 
model of the new, automated system. We 
won't worry anymore about this aspect of 
system .specification, since I suspect you 
won't be starting with an existing manu- 
al system of any kind when you sit down 
to write the ST arcade game of the year. 

Context diagram 

Okay, let's get started with the logical 
model for Reaction Time. The modeling 
tool used to represent our system at its 
most abstract level is called the "context 
diagram." Figure 1 shows the context di- 
agram for Reaction Time. Our system is 
represented by the circle labeled "Chem- 
ical Reaction Game." (Remember, this is 
a logical model, so I won't even give it an 
official name here.) The objects in rectan- 
gular boxes are external to our system, yet 
they have some communication with the 
system. These are the player, a joystick and 
a joystick trigger. 



Figure 1 . Context Diagram for Reaction Time 
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The lines with arrowheads indicate the 
communication between the external ob- 
jects and the system itself; they represent 
data flowing from one object to another. 
In this case the player is supplying some- 
thing called "inputs" to the system, and 
the system gives him back something 
called "scores." The joystick's contribution 
is labeled "stick deflection," and the 
joystick trigger supplies a "trigger press." 

The context diagram is a special case 
of a very important modeling tool called 
a "data flow diagram" or DFD. There are 
really only four kinds of objects in a DFD: 
processes (shown as circles, or sometimes 
as rounded rectangles; sometimes called 
a "bubble"); externals (shown as rectan- 
gles; sometimes called "terminators"); 
data flows (shown as lines with arrow- 
heads); and data stores (but not on the 
context diagram; stay tuned). All of these 
objects must be labeled, as they are in 
Figure 1. On the context diagram only 
one process is shown, which represents 
the entire system. 

The context diagram often is labeled 
with a zero, as in Figure 1. This indicates 
that, on another piece of paper, we are 
going to peer inside this one bubble and 
see what it contains in more detail. The 
magnified view of object "Chemical Reac- 
tion Game" will be labeled the zero-level 
diagram, and it will be another DFD con- 
taining the four kinds of objects men- 
tioned in the previous paragraph. 

I can hear you now. You're saying, "I'm 
never going to bother drawing context di- 
agrams and data flow diagrams, because 
I don't need to go through this analysis 
jazz for my programs. I've got it all in my 
head." Well, that may be. However, read 
on, because these same diagramming 
tools are also used in the structured de- 
sign phase, and I'll guarantee you that you 



don't have the entire design for a program 
of more than 100 lines in your head. 
DFDs really do help you understand both 
what you want your system to accomplish 
(during analysis) and how to go about ac- 
complishing it (during design). 

Okay, I admit it, this context diagram 
has a little bit of physical model flavor. Af- 
ter all, I did mention physical "things" like 
a joystick and a joystick trigger, yet I didn't 
say anything about a mouse. It's some- 
times difficult to completely separate the 
what of the system from the how. My own 
experience has been that, for smallish 
software projects, only one model is real- 
ly necessary at the analysis step, and that 
is the physical model. In the case of Reac- 
tion Time, there wouldn't be an enor- 
mous difference between the logical and 
physical models of the new system. And, 
since I'm not really converting an exist- 
ing system, there's no need to create phys- 
ical or logical models of a current system. 
Your choice of which models to build dur- 
ing system analysis should be dictated not 
by dogma, but by the scope, nature, and 
complexity of your application. 

Partitioning 

The next step of analysis is to start 
breaking down your system into smaller 
pieces, by turning your microscope on to 
the context diagram. Begin by drawing 
the zero-level data flow diagram; the one 
for Reaction Time is shown in Figure 2. 

Notice that Figure 2 contains several 
processes, numbered with integers. The 
fundamental definition of a process is 
something that converts inputs into 
outputs — nothing fancier than that. Bas- 
ically, this is what all computer programs 
do, so we must be on the right track. Ev- 
ery function performed by the Reaction 
Time system must be represented by a 
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Figure 2. Zero-Level Diagram for Reaction Time 
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process on the zero-level diagram. After 
all, the zero-level DFD is just an expan- 
sion of the single bubble on the context 
diagram, which contained the entire sys- 
tem, so this makes some sense. 

The step of breaking the entire system 
into separate logical functions is called 
"partitioning," and it is mighty important. 
A certain amount of partitioning will be 
intuitively obvious. Some functions will 
just jump out at you and exclaim, "I'm a 
process, I'm a process!" But often the 
separation between one process and 
another won't really be clear. You may 
find that there are several ways you can 
think about splitting parts of the system 
into separate logical processes. Don't feel 
bad if it takes a few tries to get it right. 

We'll go through partitioning again 
when we enter the design phase, in which 
the physical model of the new system (one 
product of structured analysis) will be 
used to figure out exactly how we are go- 
ing to implement our system. We'll talk 
more about the importance of partition- 
ing and modular program design in fu- 
ture articles, but trust me when I say yet 
again how important it is to do a careful, 
thoughtful job of partitioning your 
system. 

Data-flow diagrams 

Since they are so important, let's take 
a closer look at the anatomy of a data flow 
diagram. Please turn again to Figure 2. I 
have partitioned the Reaction Time sys- 
tem into six main processes: Choose Reac- 
tion File, Load Reaction Data, Build 
Equation, Evaluate Equation, Change 
Scores and Display Scores. These process- 
es are numbered from 1 through 6. 

Important rule No. 1 for DFDs: A DFD 



tween the data flow diagram and a di- 
agramming tool with which you may be 
more familiar, the flowchart. 

Important rule No. 2 for DFDs: All ex- 
ternals shown on the context diagram 
must appear on the zero-level diagram. 
Recall that the external objects are shown 
in rectangular boxes; Reaction Time has 
the three externals labeled Player, Joystick 
and Joystick Trigger. The zero-level dia- 
gram shows more detail about exactly how 
these externals connect to the different 
processes in the system. You see that Play- 
er appears in two places in Figure 2. This 
is just a matter of graphical convenience, 
so the data flow lines don't cross over one 
another. 

Think of the context diagram as a "par- 
ent" diagram, and the zero-level diagram 
as its "child." It's important that each child 
DFD be consistent with its parent DFD as 
far as things like externals and data stores 
go. Those objects represent the connec- 
tions between a process and either the 
outside world, or other processes within 
the system. For example, if we expanded 
process 1 from Figure 2 into yet a more 
detailed DFD, it had better have input 
from the external called Player and it had 
better generate output to the data store 
called Filename. You could invent other 
data stores that functioned entirely wi- 
thin the subprocesses of process 1, but 
these two key objects absolutely must be 
present. 

Important rule No. 3 for DFDs: Bubbles 
don't talk to bubbles. That is, you 
shouldn't have a data flow line going 
directly from one process to another. In- 
stead, it should go into a data store, with 
a second flow coming out of the data 
store into the second process. Some DFD 



If you can't give a data flow a reasonable name, 
odds are that you don't have a clear idea of 
what data is represented by that flow line. 



does not imply anything about the se- 
quence in which processes are carried 
out. (There's an exception to this, which 
we'll get to later on.) The numbering sys- 
tem in each level of a DFD is arbitrary. 
You shouldn't be tempted to look at 
Figure 2 and conclude that process 1 al- 
ways takes place before process 2. Of 
course, some of your partitioning will be 
based on just such sequential thinking, 
but the general rule is to not attempt to 
infer sequence information from a DFD. 
This is a very important distinction be- 



advocates don't worry about this conven- 
tion, but I've come to appreciate it, for 
reasons that will become more obvious 
when we talk about structured design. Pa- 
tience, please. 

Just what is a data store? Nothing more 
than a logical grouping of some informa- 
tion that's used in your system. In a logi- 
cal model, a data store just represents a 
block of data. In a physical model of the 
current system, a data store could 
represent a paper form that's filled in by 
one person in your organization and 
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handed to another person. In a physical 
model of the new system, a data store 
might be a disk file. At this stage of our 
analysis, the nature of each data store isn't 
as important as its contents. And we'll wait 
to think about actual file formats until 
much later. 

The data stores in Figure 2 have labels 
like Filename, Reaction Files, Reaction 
Info, Equation, Evaluation and Scores. 
Notice that many of the data flows have 
exactly these same names. This should 
come as no surprise. After all, it is data 
that is flowing from one process to 
another, and data stores are simply col- 
lections of data. However, sometimes a 
process needs only part of the data in a 
particular store. 

For example, in Figure 2 there's a data 
flow named Chemical Formulas coming 
out of a data store named Reaction Info. 
How is this possible? Well, we can con- 
clude that the thing called Chemical For- 
mulas must be just one part of the thing 
called Reaction Info. On the other hand, 
process 4 wants everything out of Reaction 
Info, so the flow has the same name as the 
store. Make sense? In our next software 
engineering installment, we'll talk about 
exactly how to define all the objects in a 
system model. 

Important rule No. 4 for DFDs: Label 
all data flows. If you can't give a data flow 
a reasonable name, odds are pretty good 
that you don't have a clear idea of what 
data is being represented by that flow line 
Repartition your system until all the flows 
can be logically named. And things like 
"Data" and "Information" do not in them- 
selves constitute reasonable names, so 
don't think you can be sloppy at this stage. 

Some DFD conventions allow you to 
leave a data flow unlabeled if and only if 
the flow is connected to a data store. In 
such cases, the flow label is assumed to 
be the same as the name of the store. Of 
course, if the flow is supposed to 
represent only a portion of the contents 
of the store, as we just saw, you'd better 
give it a separate name. In my DFDs, any 
unlabeled flow will indeed indicate that 
the flow name is the same as the name 
of the data store to which it is connected. 

We'll leave data flow diagrams for now, 
but they'll be back. There are some other 
important rules for DFDs we still need to 
talk about. 

Data Dictionary 

Even in this tiny model of this little sys- 
tem, we have already introduced no less 
than six processes, three externals, six 
data stores and 18 data stores (if my count 



is correct). How in the world are we go- 
ing to keep track of all these names and 
what they mean? And how are we going 
to keep track of things like the fact that 
the data flow Chemical Formulas is a part 
of the data store Reaction Info? We need 
another tool, called a "Data Dictionary." 
The name is pretty self-explanatory. 

But, we don't have time to talk about 
data dictionaries today. Please tune in 
next time, when we'll continue our discus- 
sion of structured analysis and system 
specification. Once you learn about data 
dictionaries, your life will be transformed. 
Well, maybe that's a slight exaggeration, 
but it's certainly true that using these 
analysis and design tools will speed your 
metamorphosis from a casual program- 
mer to a genuine software engineer. 
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primary purpose of this ar- 
ticle is to show how to install a C routine 
or function as an interrupt driver. The 
interrupt that we will use is our old 
friend, the vertical blank interrupt (VBI). 

In the course of doing this, I will show 
how to link to an external module (de- 
veloped in assembly language) from C 
and how to get into the supervisor mode 
of the 68000. 

Many of you are aware that C has 
pointers which can be used to point to 
the memory locations of its variables; 
well, C also has pointers to functions. If 
we put the value of this pointer into an 
interrupt vector, then our function will 
be executed every time that the interrupt 
is called. 

The ST VBI system has what it calls a 
queue, where users can put their own in- 
terrupt routines. In color systems this 
happens exactly 60 times a second (50 Hz 
in Europe); in monochrome, 70 times a 
second (I'm not sure if this is exact). 

Although there are BIOS or XBIOS 
calls for installing interrupts in many of 
the ST's various systems, there is appar- 
ently none for the VBI. In this case, we 
must put the 68000 into the supervisor 
mode so that we can access the memory 
locations involved. Since initially I had 
some trouble getting the call ( Super( ) ) 
provided for doing this to work, I wrote 
and linked my own trap handler to do 
it. I have since had success with Super( ) 
but I have left the Trapl( ) routine in this 
program for educational purposes. 

The Trap 1 handler (Listing 2) is mo- 
deled on the Hitchhiker's Guide trap 14 
handler; however, this one works with C. 
The two changes needed are: 1) declare 

the trapl label as a globl (notice that 

the assembler leaves out the "a"), and 2) 
declare the storage allocaton by .ds.L 1, 
not .ds.l. The global declaration allows 
us to call the "function" from C by the 
label name. The storage must be allocat- 
ed as a long because we will be saving the 



address of the user stack. 

In the C program (Listing 1), we first 
declare the function, traplf ), then we call 
it. We pass the arguments 0x20 (i.e., 20 
hex) and OL. We thus called a 68000 trap 
# 1 exception. The trap handler then 
calls the operating system routine indi- 
cated by the code 0x20. This routine puts 
the 68000 into supervisor mode. 

The supervisor stack pointer is load- 
ed with the current value of the user 
stack pointer when the second argument 
is OL; L meaning a longword. (I use up- 
percase L because the lowercase is often 
confused with the numeral 1.) The trap 
handler then passes the old, supervisor 
stack-pointer value back to us in 

Since it is declared as a pointer, 
the compiler sees to it that it's 
incremented as a pointer and 
not as, say, an integer when we 
increment it. 

save ssp. When we return to user mode, 

we will pass save ssp in place of OL, so 

as to return to where we left off. While 
in supervisor mode, you should be care- 
ful of using the BIOS or XBIOS routines 
because many of them put the 68000 into 
the supervisor mode during execution. 
Thus, calling these routines often hangs 
the system. (Exactly why is not clear to 
me, since many of the normal VBI func- 
tions must be executed from the super- 
visor mode. Perhaps the VBI is more 
careful in checking to see if the 68000 
is already in that mode or not.) 

Installing the VBI 

To install our VBI, we must find the 
queue and then find an empty space in 
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Figure 1 
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that queue — indicated by a longword of 
all Os (see Figure 1). The queue has only 
enough space for eight interrupt vectors, 
so conservative programming demands 
that we test for the number of vectors in 
the table. 

The function vbiset( ) is a general rou- 
tine for installing VBIs in the ST. It will 
install our routine on the bottom of the 
queue if we enter with an ASCII passed 
to the variable process. If we pass an "n" 
instead, it will disengage our routine by 
writing a OL to the queue. Note that if 
you have put other routines under the 
one being disengaged, they must be 
moved up. 

The interrupt routine vbiroutine( ), 
must be declared in vbiset( j. The pointer 
to vbiroutine( ) is then simply vbiroutine. I 
declared vbiroutine to be an integer be- 
cause I am using integers in the routine 
but, since I am not actually returning any 
values out of vbiroutinef ), I suppose that 
it could just as easily have have been 
declared as returning a char or a long. 
However, it must be declared as 
something. 

Two other pointers are used in vbiset( ): 
vbiqueue and vbiempty. Vbiqueue is set equal 
to 0x456L. This is the memory location 



of the pointer to the queue. Thus vbiempty 
= vbiqueue, makes vbiempty equal to the 
first vector in the table of interrupt vec- 
tors. Since it is declared as a pointer, the 
compiler sees to it that it's incremented 
as a pointer and not as, say, an integer 
when we increment it. 

Note that since the 68000, unlike the 
6502, changes the whole address in one 
operation, we never have to worry that 
another interrupt will occur while we are 
changing the address. Thus there is no 



The ST VBI system has what it calls 
a queue, where users can put 
their own interrupt routines. 



need to turn off interrupt processing 
during this instruction. In fact, when I 
set the TOS variable vbisem (hex 452) to 
0 and tried to install a routine, it hung 
the system. Vbisem is used as a flag by the 
TOS during the VBI process itself, and 
it should probably not be altered by the 
user. 

Our little VBI routine simply incre- 
ments points at the rate of 60 (or 70) 
times a second. The while loop in main( ) 
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just prints out the value of points until 
it has reached 600 (when ten seconds 
have passed). Then the vbi queue is 
returned to normal and we end the pro- 
gram. Since I wanted to increment points 
on successive interrupt calls, I declared it 
to be an external (equivalent to a global) 
variable. Thus, it remains in existence be- 
tween calls to vbiroutine( ) and is also 
accessible to our print loop in main( ). 

While in supervisor mode, you 
should be careful of using the BIOS 
or XBIOS routines because many 

of them put the 68000 into the 
supervisor mode during execution. 

The vbiset( ) routine can be made more 
general by putting the supervisor entry 
and exit within it and by eliminating the 
calls to printf( ) and getchar( ). 

Typing it in 

Now I'll explain some of the mechan- 
ics of writing the program. (I used Atari's 
Developer's Kit.) First type Listing 2 into 
the editor and save it. Then find the util- 
ities disk and call up COMMAND.PRG. 



The assembler is on the compiler disk. 
If you have a single drive system, you will 
have to copy the "trapl( )" source code 
to it. Then type "as68 - L trapl.s trapLo." 
Single drivers: transfer the object file to 
the linker disk. Type in the new linker 
batch file (Listing 3). This may or may 
not be the approved order of linking but 
it works. 

I had a lot of trouble with the compil- 
er when my programs got above a certain 
size. Since I was compiling to a second 
double-sided drive with an almost emp- 
ty disk, I was going crazy. It turns out that 
the assembler writes an intermediate file 
to its own disk, regardless of what drive 
your source code is on. The batch pro- 
grams in Listing 4 and 5 will force the 
intermediate file to be written to either 
a floppy B (type C2 filename in the batch 
dialog widow) or drive C (C3 filename), 
a hard disk or a ramdisk. When I C3 with 
a ramdisk, the assembler just flies. 

A final note: I find that when the com- 
piler or linker fails, my source (.C or O) 
file often gets wiped out, so I always keep 
a backup of each file. By the way, press- 
ing a key during the various operations 
(there are about four for the compiler), 
will call the abort query, allowing you to 
save some time. For instance, if the 
preprocessor has found some errors, you 
can exit without going through the as- 
sembly operation. 



VBI's From C — Listing 1 
C 



/wvbiart.c v. 2 */ 
/* copyright 1988 by ST-Log */ 



ainc lude 
H include 
tlinc lude 
nine lude 
ainc lude 
ainc lude 
ainc lude 



"stdio.h" 

"define. h" 

"osbind.h" 

"gendefs.h" 

"vdibind.h" 

"obdefs.h" 

"easyc . h" 



int points; 

nainO 
BEGIN 

extern int points; 

char process, c; 

long save_ssp; 

long trapK); 



save_ssp = trapl(8x28, 8LJ ; /* enter supervisor node */ 



printf ("press the s key to begin "J J 
WHILE ((c=getchar(» NE 's') 
EHDWHILE 

points = 8; 

process = "i"; /* set up vbi */ 

vbiset (process! ; 
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WHILElpoints LE 608) 

printf ("points= Xd \n", points) ; 
ENDWHILE 

/* restore nornal vbi */ 
process = 'it* J 
vbiset (process) ; 



trap! (8x20, save_ssp); /* EXIT SUPERUISOR NODE */ 



printf ("press any key to exit Sn") 1 

getchar () ; 
END 



vbiset (process) 
char process; /* an 1 i' to install the vb routine, */ 
/* an "n" to return to nornal */ 

BEGIN 
int vbiroutine () ; 
int i; 

long *vbiqueue , Kvbienpty; 
int *sshiftnod, *tiner_ns; 
int x =8; 
char *pxi 

/* addresses nust be long */ 
vbiqueue=8x456L; 
vbienpty = ffvbiqueue; 

printf ("process^ Y.c \n", process); 

WHILE (x<=8 AND (*vbienpty NE 8x8D) 
vbienpty = vbienpty + 1; 

printf ("vbienptyr xLx, *vbienpty = xLx Sn", vbienpty, Kvbienpty) ; 

x=x+l; 
ENDMHILE 

printf ("press to change vector Sn") ; 

IF (process EQ 1 i") THEN 

printf ("installing vector, vbiroutine= XLx Sn", vbiroutine) ; 
printf ("goSn") ; 
getchar (); 

wvbienpty = vbiroutine; /* install vector */ 
ELSEIF ( (*(vbienpty-l) EQ vbiroutine) AND (process EQ 'n')) 

printf ("disengage interruptSn") ; 

getchar () ; 
*(vbienpty~l) = 8x8L; 
ENDIF 

END 

vbiroutineO /* TOGGLE OUTPUT, INCREMENT POINTS */ 



BEGIN 
extern int points; 

points = points *JU /* just increases points by 1 every vbi */ 

END 



VBI's From C — Listing 2 
Assembly 

.globl _trapl 
-trapl: 

nove.l (sp)+, trlret ; pop ret addr 
trap ttl ; do BIOS function 

nove.l trlret, -(sp) ; return to 
rts ; caller 

. bss 

trlret: .ds.l 1 * saved ret. addr 
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VBI's From C — Listing 3 

Batch File link68 [u] Xl.68k=genstart, y.l, vdibind, aesbind, osbind, genlib, libf , trapl 

relMod XI 
rn XI. 68k 
wait 



VBI's From C — Listing 4 

Batch File CP 68 xl.c xl.i 

C0G8 xl.i XI. l xi. 2 Xl.3 -f 
rn XI . i 

cl68 Xl.i XI. 2 XI. s 
rn Xl.i 
rn XI. 2 

as68 -F b: -1 -u -p Xl.s XI. o 

rn Xl.s 

wait.prg 

VBI's From C — Listing 5 

Batch File cp68 xliC xi.i 

c068 Xl.i Xl.i XI. 2 Xl.3 -f 
rn Xl.i 

C168 Xl.i XI. 2 Xl.s 
rn Xl.i 
rn XI. 2 

as68 -F c: -1 -u Xl.s Xl.o 

rn Xl.s 

uait.prg 



VBI's From C — Listing 6 
Header File 



/* EASYC.H */ 

/* LOGIC OPERATORS */ 

ttdefine AND && /* logical and */ 

ttdefine OR I I /* logical or */ 

ttdefine NOT ! /* logica not »/ 

ttdefine EQ -- /* equ val conp */ 

ttdefine NE != /* not equal val conp */ 

ttdefine LE <= /* less than or equal to »/ 

ttdefine GE >= /* greater than or equal to */ 

/* bitwise operators */ 

ttdefine BAND & /* bitwise AND */ 

ttdefine BOR I /* bitwise OR */ 

ttdefine BXOR A /* bit exclusive OR */ 

ttdefine BNOT " /* bitwise NOT */ 

ttdefine LSHF << /* left shift */ 

ttdefine RSHF >> /* right shift */ 



/* arithnetic ops */ 

ttdefine INC ++ /* increnent */ 
ttdefine DEC — /* decrenent */ 
ttdefine MOD X /* nodulo devision */ 



/* if_then_esleif_else */ 

ttdefine IFCe) C ifCe) 

ttdefine THEN t 

ttdefine ELSE > else { 

ttdefine ELSE I F CeJ > else ifCe) { 

ttdefine ENDIF ll> 

/* CASE */ 

ttdefine CASE(e) < switch(e) { 

ttdefine CASEOFCe) case e: { 

ttdefine DEFCASE default: ( 

ttdefine ENDCOF > break; 
ttdefine ENDCASE >> 

/* WHILE */ 

ttdefine WHILE (e) < while(e) { 
ttdefine ENDWHILE ;}> 

/* FOR */ 

ttdefine FOR (e) ( for(e) < 

ttdefine ENDFOR 111 

/* BEGIN */ 

ttdefine BEGIN f 
ttdefine END > 
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MICROCOMPOSfTIONS 

by Michael Gogins 



The term "computer music" 
evokes images of a PC running 
a sequencer program and con- 
trolling a bank of synthesizers — 
layering tracks, instantaneously 
transposing and correcting, and finally 
printing out a meticulous transcription 
of the human intuition. Yet the first com- 
puter musicians were interested in much 
more than simply automating the tedium 
of traditional arranging and copying. 
They wanted to hear sounds which had 
never been heard before, and to apply al- 
gorithmic and mathematical techniques 
to the actual process of composition. For 
these pioneers, a musical score did not 
have to be black squiggles on a page — it 
could as easily be a program for generat- 
ing music. 

Today, due perhaps to its academic 
heritage and association with the avant- 
garde, compositional programming is not 
as familiar to musicians and program- 
mers as sequencers and transcription soft- 
ware. Yet on the Atari ST, with its built-in 
MIDI interface, some quite interesting 
compositions can be written even in that 
resource everyone has — ST BASIC! 

To illustrate three simple but powerful 
techniques of compositional program- 
ming, I have written an ST BASIC pro- 
gram, MICROS (see Listing 1). MICROS 
contains three sub-programs, each of 
which consists of one or two pages of 
code and generates an entire piece of 
music from either a short sequence of 
notes or a few numerical constants: 

OC1 Overlap canon Lines 2000-2490 
KC1 Koch curve Lines 3000-3370 

CDl Complex dynamical Lines 6000-6230 
system 

These programs do not store se- 
quences. All they do is play a synthesizer 



in real-time by computing numbers and 
sending them to the MIDI-Out port. (If 
you want to record a sequence, you can, 
of course, plug the MIDI-Out port of your 
ST into the MIDI-In port of another se- 
quencer.) You can load MICROS.BAS into 
your ST, hook up your Casio CZ, and im- 
mediately run these compositions to hear 
some very different music. The program 
menu is self-explanatory. You can stop the 
music at any time by pressing the S key. 

Hierarchical structures 

KCl and OC1 use multiple real-time 
"processes" to build up complex compo- 
sitions. This is made possible by using a 
master timing loop which constantly 
reads the ST system timer. Within the 
loop is an event timing list of condition- 
al branches which can execute several in- 
dependent processes at the same time, 
based on note -on and note -off times 
generated by the processes themselves. 
Each process, when called, computes and 
plays only its next note before returning 
to the timing loop. (This is the closest one 
can come in BASIC to multitasking!) 
Therefore, a second process can compute 
its notes based on the notes returned by 
the first process, a third process can com- 



pute its notes based on the notes returned 
by the second process, and so on. In this 
way hierarchical or recursive structures, 
such as musical fractals, can be con- 
structed. 

Hardware and software 
requirements 

Despite its faults and the fact that it is 
an interpreted language, ST BASIC is fast 
enough for some simple real-time com- 
positional programming. (You can always 
use a BASIC compiler such as GFA BAS- 
IC if you want to speed things up, attain 
more precision, or do modular 
programming.) 

These programs are written to play the 
Casio CZ-101 synthesizer. The ability of 
this common, inexpensive machine to 
play up to four different timbres at the 
same time makes it suitable for realizing, 
all by itself, fairly sophisticated composi- 
tions. Therefore each program contains 
mode and program change messages for 
accessing favorite patches I have stored in 
the Casio's internal memory. Experiment 
with the program change messages to find 
the best sounds on your machine. 

If you do not have a CZ, you will have 
to change the syntax to control your own 



On the Atari ST, with its built-in 

MIDI interface, some 
interesting compositions can be 
written even in ST BASIC! 
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synthesizer. Or, if you have no synthesiz- 
er at all, you can still get three notes at 
a time out of the sound chip in the ST. 
Replace the note-on and off statements 
in Lines 380-480 with SOUND statements, 
and replace the various program change 
statements with WAVE statements. 

KC1 — a musical fractal 

This program (Lines 3000-3370 in List- 
ing 1) was inspired by VARIATN.BAS, a 
program written by Curtis Bahn to gener- 
ate musical fractals for the Yamaha 
CX5-M, an MSX computer with a built- 
in synthesizer. (See Charles Dodge and 
Curthis R. Bahn, "Musical Fractals," Byte, 
June 1986, p. 185.) 

If you want to understand fractals in 
depth, read Benoit Mandelbrot's book, 
The Fractal Geometry of Nature (W.H. Free- 
man and Company, 1983). Basically, a 
fractal is a curve which has wiggles or 
spikes on top of wiggles or spikes, ad in- 
finitum, so that the curve actually fills up 
a measurable fraction of its region of the 
plane (hence the term "fractional dimen- 
sion"). (A circle, square, or other ordinary 
curve, being only one point wide, fills only 
an infinitesimally small part of the plane.) 
For example, to construct a Koch or snow- 
flake curve, take an equilateral triangle, 
stick three smalJer equilateral triangles on 
its sides, stick three yet smaller triangles 
on the sides of those triangles, and so on 
to infinity. 

A musical Koch curve is constructed by 
taking a simple melody as a generator. On 
top of each note in the generator is then 
played a tiny copy of the generator, which 
makes a second and faster layer of mus- 
ic. On top of each note in the second lay- 
er is then played a yet tinier copy of the 
generator, which makes a third and yet 
faster layer of the "snowflake," and so on. 
KC1 has four such layers. 

KC1 is called by the master timing loop 
in Lines 160-240 of MICROS. Lines 
3110-3160 of KC1 are an event timing list 
for the four layers of the musical snow- 
flake. Lines 3010-3100 of KC1 are an in- 
itialization section, which switches itself 
off after the first call from the timing 
loop. (For a detailed understanding of the 
MIDI statements which program the CZ, 
consult the MIDI 1.0 Specification of the In- 
ternational MIDI User's Group, or see 



Experiment 
with different 
durations, 
pitches and 
numbers of 
notes in the 
generator to 
create new 
compositions. 

Even a 
small change 
to the 
generator 
makes a 
big change 

in the 
final music! 



John Jainschigg, "Sound Chip Part 3: A 
Nuts and Bolts Guide to MIDI," Atari Ex- 
plorer, Summer 1987, p. 78.) KCNOTES is 
the number of notes in the "generator" 
melody, KCLEN is the total duration of 
the piece of music in 200ths of a second, 
and KCSTART is the MIDI note number 
upon which the snowflake curve is built. 
The data in Line 3080 specifies the gener- 
ator in terms of alternating pitch move- 
ments and durations as fractions of the 
total duration (i.e., add three half steps to 
the starting point and play the resulting 
note for .2 of the total duration, add seven 
half steps to the starting point and play 
the result for .2 of the total, and so on). 

On each call from the master timing 
loop, control passes to the event timing 
list in Lines 3110-3160. On the first pass, 
all note on times are 0, and each process 
is executed immediately in turn. 

The first process, in Lines 3170-3210, 
increments a counter which steps through 
the generator one note at a time. The ap- 
propriate number of half-steps are added 
to the starting point to obtain NOTE1, 
which is turned on by calling a subrou- 
tine. NOTEl's duration is then comput- 
ed by multiplying its fractional duration 
by the total duration, and the next note 
on time is computed by adding NOTEl's 
duration to the current note-on time. 
Control then returns to the event timing 
list. 

The second process works exactly the 
same way as the first, except that NOTE1 
is used for the starting point, and the du- 
ration of NOTE1 is used instead of the to- 
tal duration of the piece, so that a copy 
of the generator is played (as NOTE2) on 
top of each note of the generator. The 
third process is similarly built up 
(NOTE3) on top of the second, and the 
fourth (NOTE4) on top of the third. Con- 
trol then returns to the master timing 
loop. On each subsequent pass through 
the timing loop, each process will be 
called only at its appropriate time, and 
will compute only its next note. 

Experiment with different durations, 
pitches, and numbers of notes in the 
generator in Lines 3050-3080 to create 
new compositions. Even a small change 
to the generator makes a big change in 
the final music! Just make sure all the frac- 
tional durations add up exactly to 1. 
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OC1 — an overlap canon 

A canon, or round, is simply a melody 
which is played against itself after a cer- 
tain delay. Like the musical snowflake, a 
canon can have several voices. OC1, 
however, is an overlap or differential can- 
on. (See Lines 2000-2490 in Listing 1.) 
Each voice of the canon plays one less 
note of the generator than the last voice. 
Therefore, as the layers repeat, the 
amounts of overlap or delay are constant- 
ly shifted, and the piece as a whole does 
not repeat for a very long time — more 
than a day, in fact, if you let it play that 
long! 

The initialization section and event 
timing list are similar to KC1, except that 
OCLEN specifies the fraction of each 
note duration for which the note will ac- 
tually be on. This is the degree of staccato 
or legato to be played. The processes, 
however, are simpler; each process simply 
steps through the generator melody one 
note at a time, plays its note, and com- 
putes its next note on time. The only 
difference between the processes is the 
number of notes to be read from the 
generator before repeating. 

Experiment with different melodies 
and rhythms, and especially with differ- 
ent synthesizer patches. It's interesting to 
use the same timbre for at least two of the 
voices, so that the shifting overlaps will 
interlace to generate constantly changing 
melodies. You may want to choose a 
generator whose notes do not all clash 
with each other, because at one time or 
another each note will be played against 
every other note. 

CD1— a complex dynamical 
system 

CDl (Lines 6000-6230 in Listing 1) 
takes a totally different approach to mus- 
ic The entire composition is generated 
by a single, very simple equation in Lines 
6160-6170, and the music is completely de- 
termined by a choice of four numbers. 

The mathematics is based upon arith- 
metic in the complex plane, where each 
point is represented by two numbers, a 
real (or X) component and an imaginary 
(or Y) component. For musical purposes, 
each point in the plane can also be 
thought of as representing two notes, one 
on an X keyboard and one on a Y key- 



Experiment 
with different 

melodies, 
rhythms and 
synthesizer 
patches. It's 
interesting to 
use the same 
timbre for at 
least two of 
the voices, so 
that the shift- 
ing overlaps 
with interlace 
to generate 
changing 
melodies. 



board. Complex arithmetic specifies the 
rules for adding, subtracting, multipying, 
and dividing points. 

The equation Z< =Z A 2 -M me- 
ans: take the point Z, square it and sub- 
tract from it a constant point, M. Then 
make Z equal to the result, and repeat the 
procedure. As the equation is iterated, Z 
hops about on the plane — playing, ac- 
cording to our musical interpretation, 
two-voice counterpoint. This is a complex 
dynamical system. And the behavior of Z 
depends very sensitively on the value of 
M. For some values of M, Z hops very 
quickly off to infinity; for other values of 
M, Z spirals down into some stable point 
and stays there; for yet other values, Z 
whirls about until it settles into a hopping 
orbit with two, three or however many 
points. 

If each point on the plane is taken as 
M and colored black if Z=0 never goes 
to infinity, or some other color according 
to how fast Z=0 does go to infinity, a map 
of the Mandelbrot set will be produced. 
The Mandelbrot set is one of the most 
complex and fascinating objects in all 
mathematics, because no matter how 
much it is enlarged, it reveals more and 
more detail, never exactly repeating itself 
as most fractals do. I used the set to 
choose an interesting value of M for CDl. 
Ms from the black region, the inside of 
the set, but close to the edge, produce 
relatively complicated orbits of Z. For 
more information about the Mandelbrot 
set and other fractals, with awesome color 
pictures, see H.O. Pietgen and P.H. 
Richter, The Beauty of Fractals: Images oj 
Complex Dynamical Systems (Berlin, 
Springer Verlag, 1987). You may be able 
to find public-domain programs for 
generating maps of the Mandelbrot set on 
the ST. 

Experiment with CDl by changing 
CDMR and CMI, the value of M, and/or 
CDZR and CDZI, the initial value of Z, 
which does not need to be 0. To guide 
your explorations, you may want to use 
one of the public-domain ST programs 
for mapping the Mandelbrot set. 



Michael Gogins is 37 years old, has a RA. in com- 
parative religions and is supporting himself by 
word processing and dEASE programming while 
he tries to get a career going xvriting science fic- 
tion. He plays the flute, writes music and will fur- 
ther pursue compositional programming. 
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Micro Compositions — Listing 1 
ST Basic 



18 MICROCOMPOSITIONS: 1 Michael Gogins 
/ June 38, 1987 
28 ' 

38 DIM OCM (188, 2)' Overlap canon score 

array 
48 ' 

58 OPENW 2 : FULLW 2:CLEARW 2: COLOR 1,1, 

2,8,8* Menu background 

68 LINEF 58,28,548,28:LINEF 548,28,548 

,138 

78 LINEF 548,138, 58, 138:LINEF 58,138,5 
8,28 

88 COLOR 3, 3,3, 4, 2:FILL 8,8 
98 ' 
188 1 

118 COLOR 1,8,8,8,8' Menu header and f 
ooter 

128 GOTOXV 11,3:PRIHT "MICR0C0MP0SITI0 
MS / Michael Gogins / June 38, 1987" 
125 GOTOXV 22,5:PRIHT "PRESS K>EV TO S 
ELECT:" 

138 GOSUB MIMENU 

148 GOTOXV 22, 12 : PRINT "Q>uit" 

158 ' 

168 POKE 12108,0' MASTER TIMING L80P - 

Reset systen tiner 
178 WHILE MIKEV04351' While "Q" not p 
ressed 

188 MIKEV=PEEK(&HFFFC821 ' Peek keyboar 
d ACIA register directly for speed 
198 IF MIKEV>255 THEN GOSUB MIMENU' Do 
nenu if key pressed 
288 TIME«=PEEK(1218«1 ' Read systen tin 

218 ON MIPLAV G8SUB OC1, KC1,CD1' Maste 
r event tining list 
248 WEND 
258 ' 

268 G8SUB MIOFF : END 
278 ' 

288 MIMENU : GOSUB MIOFF 1 Menu with sele 
ction highlighted 

298 IF MIKEV06399 THEN COLOR 1 ELSE M 

IPLAV=l:0CINIT=8:C0L0R 2 

388 GOTOXV 22, 7:PRINT "Overlap canon" 

310 IF MIKEV09727 THEN COLOR 1 ELSE M 

IPLAV=2:KCINIT=8:C0L0R 2 

328 GOTOXV 22, 8:PRINT "fOoch curve" 

338 IF MIKEV012831 THEN COLOR 1 ELSE 

MIPLAV=3:CDINIT=8:CCLBR 2 

348 GOTOXV 22, 9: PRINT "Oonplex dynani 

cal systen" 

358 IF MIKEV08191 THEN COLOR 1 ELSE M 
IPLAV=8:C0L0R 2 

368 GOTOXV 22, 18:PRINT "S>top playing" 
: RETURN 
378 ' 

388 MIOFF: GOSUB 0FF1: GOSUB 0FF2: GOSUB 
0FF3: GOSUB 0FF4: RETURN 
398 ' 

488 REM Note on and off routines for c 
hannels 1-4 

418 0Nl:0UT 3,144:0UT 3,N0TE1:0UT 3, SG 
N(N0TE1)*64:RETURN 

428 OFFliOUT 3, 144: OUT 3, NOTEliOUT 3,8 
• RETURN 

438 0N2 J OUT 3, 145: OUT 3,N0TE2:0UT 3, SG 
N (N0TE2)*64 : RETURN 

448 0FF2:0UT 3, 145:0UT 3, N0TE2:0UT 3,8 
: RETURN 

458 8N3:0UT 3, 146:0UT 3, N0TE3:0UT 3, SG 
N (N0TE3)*64 : RETURN 

468 0FF3:0UT 3, 146: OUT 3,N0TE3:0UT 3,8 
: RETURN 



478 0N4:0UT 3,147:0UT 3,N0TE4:0UT 3, SG 
N (N0TE4)*64 : RETURN 

488 0FF4:0UT 3, 147: OUT 3, N0TE4:0UT 3,0 
: RETURN 
498 ' 

2868 OCl:' Overlap canon 
2016 IF 0CINIT=1 THEN GOTO OCON ELSE 0 
CINIT=1' Initialization 
2828 OUT 3, 176: OUT 3, 126: OUT 3,4' Mono 
node 

2030 OUT 3, 192: OUT 3, 37: OUT 3, 193: OUT 

3,35' Internal prograns 
2848 BUT 3, 194: OUT 3, 38: BUT 3, 195: OUT 

3,35' Next: tine paraneters 
2858 0CN0TES=18 : 0CBEAT=56 : 0CLEN= . 75 : OC 
REPS=18:6CREP=8 

2868 6CI1=8:0CI2=8:0CI3=8:0CI4=8 

2878 DATA 38,4,41,4,57,2,62,1,65,1,58, 

2,67,2,66,4 

2888 DATA 39,4,78,4,77,1,69,2,77,1,74, 
3,72,3,42,4,44,4,46,4 

2898 REST6RE 2878: FOR 0CI=1 TO OCNOTES 
2108 READ OCM (OCI, 1) : READ OCM (OCI, 2J 
2118 OCM (OCI, 2) =0CM (OCI, 2)*0CBEAT : NEXT 
2128 OCONTltt=TIMEtt : 0C0FFT1»=TIME»+0CBE 
AT 

2138 0C0NT2tt=TIMEtt : 0C0FFT2n=TIME«+0CBE 
AT 

2148 0C0NT3tt=TIMEtt : 0C0FFT38=TIMEtt+0CBE 
AT 

2158 0C0NT4tt=TIMEtt:0C0FFT4tt=TIMEtt+0CBE 
AT 

2168 OCON:' Event tining list 

2178 IF TIME8>=0C0NTltt THEN GOSUB OCON 

1 

2188 IF TIME»>=0C0FFT1» THEN GOSUB OFF 
1 

2198 IF TIME*>=0C0NT2» THEN GOSUB OCON 

2 

2288 IF TIMEt»=0C0FFT2tt THEN GOSUB OFF 

2 

2218 IF TIMEtt>=0C0NT3tt THEN GOSUB OCON 
3 

2228 IF TIME«>=0C0FFT3« THEN GOSUB OFF 

3 

2238 IF TIMEtt>=0C0NT4tt THEN GOSUB OCON 
4 

2248 IF TIMEtt>=0C0FFT4tt THEN GOSUB OFF 
4 

2258 RETURN' Next are overlapping cano 

2268 OCONl:' Turn on Uoice 1 

2278 0CI1-1+0CU MOD OCNOTES : IF 0CU=1 

THEN 0CREP=0CREP+1 
2288 IF 0CREP>0CREPS THEN GOSUB MIOFF: 
SHPLAV=8: GOSUB MIMENU : RETURN 
2298 N0TE1=0CM(0CU,1) :G0SUB ONI 
2388 0C0FFTltt=0C0NTi«+0CM (OC II, 2)*0CLE 
N 

2318 0C0NT1«=0C0NTHI*0CM(0CI1, 2J : RETUR 
N 

2320 0C0N2:' Turn on Uoice 2 

2338 IF 0CREP>0CREPS THEN GOSUB MIOFF: 

MIPLAV=8:G0SUB MIMENU : RETURN 

2348 0CI2=1+0CI2 MOD (0CN0TES-1) 

2358 H0TE2=0CM(OtI2,l) : GOSUB 0N2 

2368 0C0FFT2tt=0C0NT2»+0CM (0CI2, 2)*0CLE 

N 

2370 0C0NT2tt=0C0NT2»+0CM(0CI2,2) : RETUR 
N 

2388 0C0N3:' Turn on Uoice 3 

2398 IF 0CREP>0CREPS THEN GOSUB MIOFF: 

MIPLAV=8:G6SUB MIMENU I RETURN 

2488 6CI3=1+0CI3 MOD (0CN0TES-2J 
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2418 N0TE3=0CM(0CI3,1) : GOSUB 0N3 

2426 0C0FFT3«=0C0NT3»+0CM(0CI3, 2)*0CLE 

N 

2438 0CONT3*=0CONT3«+0CM(0CI3,2) : RETUR 
N 

2448 0CON4:' Turn on Voice 4 

2458 IF 0CREP>0CREPS THEN GOSUB MIOFF : 

MIPLAV=8:G0SUB MIMENU : RETURN 

2468 0CI4-1+0CI4 MOD C0CN0TES-3) 

2478 N0TE4=0CM (0CI4, 1) : GOSUB 0N4 

2488 0C0FFT48=0CONT4lt+OCM(OCI4, 2J*0CLE 

N 

2498 0CONT4«=OCONT4«+OCM(0CI4,2) : RETUR 
N 

2588 1 

3808 KCl:' Koch curve 

3818 IF KCINIT=1 THEN GOTO KCON ELSE K 
CINIT=1 

3828 OUT 3, 176: OUT 3, 126: OUT 3,4' Mono 
node 

3838 OUT 3, 192: OUT 3, 37: OUT 3, 193: OUT 

3,38* Prograns 
3848 OUT 3, 194: OUT 3, 41: OUT 3, 195: OUT 

3,35 

3858 KCN0TES=5:KCLEN=3388B' Tine paran 
eters 

3068 KCU=8:KCI2=8:KCI3=B:KCI3=8:KCI4= 
8 

3878 RESTORE 3888 :KCSTART=4B ' Melody d 

at a: tines nust sun to 1 

3888 DATA 3, . 2, 7, . 2, 8, . 2, 12, . 2, 14, . 2 

3898 FOR 1=1 TO KCNOTES : READ KCGENCI,1 

) : READ KCGENCI, 2) :NEXT 

3188 KC0Tltt=T IMEtt : KC0T2»=TIMEft : KC0T3tt= 

TIMEtt : KC0T4tt=TIMEa 

3118 KCON:' Event tining list 

3128 IF TIME«>=KC0T1* THEN GOSUB KC01 

3138 IF TIME»>=KC0T2tt THEN GOSUB KC02 

3148 IF TIME»>=KC0T3» THEN GOSUB KC03 

3158 IF TIME»>=KC0T4» THEN GOSUB KC04 

3168 RETURN 

3178 KCOl:' Lager 1 (slowest) 
3188 GOSUB OFFl:KCIl=KCU+l:IF KCI1>KC 
NOTES THEN GOSUB MIMENU : RETURN 
3198 NOTE1-KCSTART+KCGEN CKCI1, 1) : GOSUB 
ONI 

3288 KCBEAT1=KCGEN (KCI1, 2)*KCLEN 

3218 KC0T1»=KC0T1»+KCBEAT1: RETURN 

3228 KC02:' Lager 2 (faster than 1) 

3238 GOSUB 0FF2 : KCI2=i+KCI2 MOD KCNOTE 

S:IF KCIDKCNOTES THEN RETURN 

3248 N0TE2=N0TE1+KCGEN(KCI2, 1) : GOSUB 0 

N2 

3258 KCBEAT2=KCBEAT1*KCGEN(KCI2, 2) 

3268 KC0T2*=KC0T2»+KCBEAT2 : RETURN 

3278 KC03: 'Lager 3 (faster than 2) 

3288 GOSUB 0FF3 : KCI3=1+KCI3 MOD KCNOTE 

S:IF KCIDKCNOTES THEN RETURN 

3298 N0TE3=N0TE2+KCGEN(KCI3,1): GOSUB 0 

N3 

3388 KCBEAT3=KCBEAT2*KCGEN (KCI3, 2) 

3318 KC0T3tt=KC0T3tt+KCBEAT3 : RETURN 

3328 KC04: 'Lager 4 (fastest) 

3338 GOSUB 0FF4 : KCI4=1+KCI4 MOD KCNOTE 

S:IF KCI1>KCN0TES THEN RETURN 

3348 N0TE4=N0TE3+KCGEN(KCI4, 1) > GOSUB 0 

N4 

3358 KCBEAT4=KCBEAT3«KCGEN(KCI4, 2) 
336B KC0T4«=KC0T4tt+KCBEAT4 : RETURN 
3378 ' 

6888 CDl:' Conplex dgnanical sgsten 
6818 IF CDINIT=1 THEN GOTO CDON ELSE C 
DINIT=1' Initialization 
6828 OUT 3, 176: OUT 3, 126: OUT 3,4' non 



o node 

6838 OUT 3, 192: OUT 3, 41: OUT 3, 193: OUT 

3,41' Internal progran 
6848 CDMR= . 636434 : CDM I = . 38785 : CDZR=B : C 
DZI=8' Pitch paraneters 
6858 CDBEAT=52 : CDLEN= . 18 : CDREP-8 : CDREP 
S=458" Tine paraneters 
6868 CDUR=l/2+l/2«SQR (1+4*SQR (CDMR A 2+C 
DMI A 2) ) ' Whirlpool radius 

6878 CDONTl«=TIMElt:CDOFFTl«=TIMEtt+CDBE 
AT 

6888 CDON: 1 Event tining list 

6898 IF TIMElt>=CDONTltt THEN GOSUB CDON 

6188 IF TIME«>=CDOFFTltt THEN GOSUB OFF 
l: GOSUB 0FF2 
6118 RETURN 

6128 CD0N1:' Two-dinensional (conplex- 

valued) dgnanical sgsten 

6138 GOSUB OFFl: GOSUB 0FF2 

6148 CDREP=CDREP+l:IF CDREP>CDREPS THE 

N GOSUB MIMENU : RETURN 

6158 CDZR2=CDZR 

6168 CDZR=CDZR A 2-CDZI A 2-CDMR' Conpute 
Z<=Z A 2-MU 

6178 CDZI=CDZR2«CDZI*2-CDMI 

6188 N0TE1=36+(CDZR+CDWR)/CDWR*3B' Nor 

nalize whirlpool 

6198 N0TE2=36+(CDZI+CDWR)/TDUR*3B' rad 
ius to MIDI kegs 36-96 
6288 GOSUB ONI: GOSUB 0N2 

6210 CDOFFTltt=CDONTltt+CDBEAT*CDLEN ' Ti 
nes 

6228 CDONTltt^CDONTltt+CDBEAT : RETURN 
6238 ' 



Micro Compositions — ST Checksums 



18 data 848, 354, 731, 358, 583, 614 
, 584, 114, 368, 471, 4945 

118 data 182, 263, 697, 119, 926, 48 
6, 292, 572, 571, 521, 4629 

288 data 948, 383, 58, 488, 496, 494 
, 411, 168, 585, 123, 3986 

328 data 861, 912, 825, 875, 568, 49 
6, 149, 582, 388, 189, 5677 

428 data 652, 284, 663, 219, 674, 23 

4, 685, 584, 844, 939, 5618 

2828 data 124, 786, 17, 874, 858, 91 

5, 957, 925, 238, 813, 6419 

2128 data 223, 238, 237, 244, 889, 8 
76, 732, 888, 738, 877, 5918 

2228 data 735, 881, 748, 476, 543, 1 
76, 993, 961, 834, 987, 7246 

2328 data 546, 987, 984, 967, 845, 9 
21, 556, 993, 988, 973, 8688 

2428 data 849, 928, 559, 992, 919, 9 
86, 868, 942, 538, 421, 7994 

3818 data 691, 126, 398, 918, 524, 6 
48, 34, 524, 615, 77, 4547 

3118 data 882, 689, 615, 621, 627, 4 
58, 578, 976, 434, 13, 5797 

3218 data 171, 223, 668, 15, 282, 18 
4, 219, 678, 27, 286, 2577 

3318 data 198, 585, 673, 32, 217, 28 
3, 541, 465, 881, 188, 3895 

6838 data 454, 658, 686, 949, 153, 8 
86, 827, 267, 451, 295, 5538 

6138 data 323, 973, 893, 315, 451, 9 
79, 358, 33, 28B, 394, 4999 

6238 data 548, 548 
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A 

Broad 
Spectrum 

An interview with the team behind Spectrum 512 

by Andy Eddy 
and 

Maurice Molyneaux 

A lot was going on at the Northeast Atari Computer Fair, held at the Worcester 
Centrum, in Worcester, Massachusetts, October 10th and 11th, 1987. Yet, even with 
attention grabbers like Mega ST4s, laser printers, WordPerfect and others, one par- 
ticular program seemed to catch almost everyone's eye: Spectrum 512, a graphics 
program which allows the ST to display its full 512 colors on screen simultaneous- 
ly. Also at the show was Digispec, software that links to the ComputerEyes video digitizer 
that makes it possible to digitize pictures into Spectrum format. On the first day 
of the show, Andy Eddy and Maurice Molyneaux interviewed the people behind 
Trio Engineering, the developers of Spectrum and Digispec. The primary force 
behind the Trio efforts is Boris Tsikanovsky, who spent his childhood on a Russi- 
an island near Japan and moved to the United States in 1979. 



^^ANALOG: When did you first start using 
computers. . .what's your background 
with them? 

TRIO: I don't know. . .for a long time 
(chuckles). 

ANALOG: Did you have any contact with 
computers in Russia or not? 
TRIO: Uh, yes. All different kinds of com- 
puters, but, uh . . . . 

ANALOG: Mainframes? 

TRIO: I guess so. I don't even know what 

it was ... it was kind of big (laughing). 
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ANALOG: You started on mainframes in 
Russia, and you moved over here in '79. 
What was your progression? What com- 
puters have you had since then? 
TRIO: One computer I used to have was 
the ZX-81. You know? 

ANALOG: The Sinclair? 
TRIO: The Sinclair. I guess we should say 
that we've been interested in the 68000 
computers, and we've been looking for a 
niche. You know, to do something in this 
area. And the Atari seemed to us to be the 
perfect computer to do something. So 
we've been looking at a variety of differ- 
ent things. . .we have concentrated on 
Atari, and I guess it worked out very well. 
So far. 

ANALOG: It appears so. 
TRIO: So that's the main thing right now. 
Let me add something, too, talking about 
general engineering experience with 
computers. Being in the United States, we 
worked with the IBM mainframes; we 
worked with the Prime computers, partic- 
ularly 850s and 9950s and the newer 
machines. . .the bigger machines. We 
worked with the VAXes, DEC computers. 
We're talking VAXes . . . 750 and up. The 
new VAXes. 

ANALOG: So you have a lot of ex- 
perience. 

TRIO: We have lots of experience with 
inter-computer communications. That's 
the company profile, not talking work on 
one particular project. It could go on and 
on and on, list after list. 

ANALOG: As a company, is this really 
your first delve into the home-based com- 
puter or personal-computer market? 
TRIO: Yeah, I would say it's not just the 
first personal computer because we do 
know Macs and IBMs and IBM PCs, but 
we never did any home- or entertainment- 
market software. 

ANALOG: And this is your first touch 
into the ST market? 
TRIO: Absolutely. 

ANALOG: Also, your first graphics pro- 
gram as well? 

TRIO: If you're talking about Spectrum, 
yeah. Spectrum was the first, and the se- 
cond product right away is the Digispec, 
which gives you access to Spectrum 
[through ComputerEyes]. 

ANALOG: This kind of thing has never 
been done with an ST before; what you've 



What this 
does is put 
into the 
hands of 
people with 

very 
inexpensive 
computers the 
power to do 
the kind of 
graphics work 
that normally 
costs a 
lot more. 



done is revolutionary. You're the first ones 
to pull off something like that. And again, 
we see Eidersoft with their Quantum Paint- 
box ... it doesn't seem to compare. 
TRIO: [Quantum's interface] is so incon- 
venient. It's absolutely inconvenient, I 
would say. You can't just paint. To me, 
when you work with painting programs, 
the only result you want to see is nice pic- 
tures on the screen. The Quantum ap- 
proach may be a good approach — but I 
haven't seen the results yet. Until you see 
those results, it's hard to say what is what. 
It's not because I'm trying to be negative, 
but I want to understand what's the limi- 
tation of that ST hardware. 

ANALOG: Well, how did you come upon 
your technology? 

TRIO: Just lucky, I guess (laughing). 

ANALOG: Just lucky? 
TRIO: I would say it took a lot of patience 
I see the problem with the other guys do- 
ing it; they start from the technical point, 
with interrupts and all of that. But then 
it remains on a technical level. You just 
can't have [the software] where you just 
paint. 

ANALOG: What you're saying is that you 
want to make it simple, for the program 
not to get in the way of what the artist is 
trying to do. It should be transparent. 
TRIO: Yes. 

ANALOG: Where did the idea for this 
particular program come from? Did you 
look at a picture on a screen and decide 
this could be better? Atari has set down 
what they say are the specifications for the 
machine. I heard that Leonard Tramiel 
saw Spectrum and said, "Well, you can't 
put 48 colors on a scan line. . . ." and sat 
down and placed 48 colors with the zoom 
mode, and walked out. But they know the 
specifications of the machine and said it 
was impossible. 

TRIO: Well, we just didn't pay any atten- 
tion to that. We worked from the 68000 
side. We saw what it can do — how much 
time it takes to change so and so (laugh- 
ing). Maybe if we'd asked him, and he said, 
"No," maybe then we would have gotten 
discouraged. 

ANALOG: It would have changed your 
mind? 

TRIO: Yeah. I want to add that to be a 
programmer [alone] is not enough to do 
this. One has to know physics: the way 
things work, the way things are displayed, 
to be able to measure the times of a par- 
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ticular operation, things like that. So you 
have to know a lot of the technical details 
from the physics side of it — not just the 
programmer's side of it — and incorporate 
it and integrate it. That's the only way to 
do it. 

ANALOG: Sort of like measuring a room 
before you move the furniture in? 
TRIO: Yes, that's the way it was. That's 
why the hardware is working at its limit 
now. 

ANALOG: I did hear that you actually os- 
cilloscoped how the machine performed 
and worked from the inside out rather 
than tried to program something. 
TRIO: Right. 

ANALOG: Can you go into detail at all 
about what you did? Your preparation for 
actually doing the programming? 
TRIO: Well, that was mainly related to the 
[system] timings . . . measuring the tim- 
ings. That's all. Look at it as simply a 
machine that works in real-time and 
[does] things. You must understand the 
machine. Programming comes later. 

ANALOG: Were you looking at specific 
sorts of applications, more than just a 
paint program? 

TRIO: It was kind of curious, because we 
were thinking first about doing some ani- 
mation stuff. Some flight simulators and 
those things. When you start to do this, 
you realize that it is too slow. When you 
redraw images, it's a lot of pixel move- 
ment. Okay, so you've got to move blocks. 
You move not just a couple of objects, but 
the background, and it's hard. 

ANALOG: Is that a limit of the ST or is 
that a general limitation? 
TRIO: It's general in that the 
microprocessor is only so fast. There's so 
much data. And there was an idea that to 
change the background maybe you 
shouldn't redraw it . . . to do it a little bet- 
ter, you have to change colors on the fly. 

ANALOG: Because you need more 
colors? 

TRIO: Yeah. And that's where it starts. 

ANALOG: So, at that point you decided 

to do a paint program? 

TRIO: Yes, to do a static display program. 

ANALOG: Were you thinking about writ- 
ing a full-featured paint program, or just 
an enhancement to take pictures from 
other paint programs? 



TRIO: Well, it was clear that we had to do 
it from scratch, because you have to have 
all the painting routines and block- 
moving routines and everything. 

ANALOG: What's the maximum number 
of colors you can have on the screen with 
Spectrum? 

TRIO: Non-interlaced? Atari hardware 
has 512 particular colors. All this stuff 
about 4096, and so forth . . . it's interlaced, 
it's dithering, it's all kinds of tricks. All we 
can get is 512, and that's the maximum. 
By the way, we explored the [interlace] 
idea — when you show one picture in even 
numbered frames and another in the odd 
numbered frames. But, you know, the 
flicker. 

ANALOG: Right. How do you think these 
other programs — that are coming out 
with these multiple palettes and these in- 
terlaced tricks — are going to affect 
Spectrum? 

TRIO: The thing is that there was a lot 
of experimentation. But nobody liked the 
flickering. So the [interlace] idea was 
dropped right there. In principle, I would 
say, with not much modification, we can 
show the same number [of colors] as 
theirs. But, again, you lose quality. We 
think that you can do pretty well with 512 
colors. 

ANALOG: You didn't use interlace be- 
cause you said that the flicker was unac- 
ceptable. Do you think that that will affect 
the other programs? 
TRIO: Let me put it this way: We had our 
choice of which way to go. I can see two 
perspectives here: Number one is the fi- 
nal result of the quality of that display, on 
the screen; and number two is the user- 
friendliness, and how comfortable you are 
working with all these tools. Now, we think 
that from both of these perspectives, our 
product is on a much higher level. If 
someone else wants to do something like 
that, it's perfectly all right to explore the 
machine or your own ideas or whatever. 
It has to be convenient. It's a paint 
program. 

ANALOG: And how long did it take to de- 
velop this program entirely from the ac- 
tual starting point? Actually working on 
it? 

TRIO: From about February [1987]. 

ANALOG: So we're talking about six, 
seven months. 

TRIO: Yeah. It was ready in August, I 
guess. 



ANALOG: That's a really incredible turn- 
around. I've seen some graphics software 
sit for six months to a year. 
TRIO: If you consider that we have pret- 
ty good backgrounds — Ph.D. in physics, 
and background in electronics, electrical 
engineering and in software — then you 
wouldn't be wondering that the technical 
level of this program is higher than the 
average. 

To do something like Spectrum 512, 
you have to have knowledge about how 
the display is working, how the image is 
created, how the computer is working, 
about all kinds of signals, about all kinds 
of software. When we're talking about 
creating software these days, people think 
that to write a program you have to know 
a particular programming language; 
either you know BASIC or you know C or 
you know Assembler. To write something 
like Spectrum 512, you've got to be pret- 
ty diversified. You've got to know some- 
thing about video images; you've got to 
know a lot about assembly; you've got to 
know about the machine. 

It's like you're working on a mainframe 
You've got to be able to work with the 
equipment available, to use that oscillo- 
scope or analyzer to get those signals 
which make sense. To do software, you've 
got to know the languages; to do hard- 
ware, you've got to be an electrical en- 
gineer. You've got to have a pretty good 
idea about electronics. 

ANALOG: People will look at this pro- 
gram and think, What routines are they us- 
ing there? They're going to be thinking 
about system calls or calling the graphics 
chips; they're not actually figuring how you 
would address the hardware to make it do 
things it normally isn't designed to when 
you go outside of the realm of defining 
Atari possibility as defined by Atari. They 
see the demos and they think, How}" 
TRIO: That's right. That was the idea. We 
are engineers; we're not just software peo- 
ple, and we're not just hardware people. 
We're an engineering outfit. We consider 
that the best way to approach a problem 
is to get a broad scope of that problem; 
to use the best available state-of-the-art 
hardware which will work with the 68000 
processor, get right to the nitty-gritties of 
that machine. And you've got to be a bit 
of an artist, too, to use the imagination 
as we've tried to do. 

ANALOG: I wanted to get into some specif- 
ics on Spectrum, per se Are you address- 
ing certain chips, but not in a normal way, 
or bypassing the normal video hardware? 
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TRIO: We are addressing the color 
palette, what is called the video shifter 
[chip], and changing the color registers 
inside it, like with display line interrupts. 

ANALOG: It seems like you must be do- 
ing it in the middle of a scan line rather 
than at the end. 
TRIO: Yeah, yeah. 

ANALOG: Which is why you need all the 
tight system timing. You have to know ex- 
actly how fast the machine is going, so you 
know how long it takes you to draw an 
electron beam across the screen. 
TRIO: Yup. I think the idea itself is rather 
obvious, but, implementation .... 

ANALOG: The most obvious things are 
often the hardest ones to pin down. 
George Lucas once said that he spent 
years trying to find the obvious. Without 
knowing the hardware as intimately as 
you do, there's no possible way of doing 
this. That's how you do something that's 
technically impossible to many, because 
they are trying to get around what they 
perceive as limits, rather than seeing what 
the actual limits of the hardware are and 
how the hardware actually works. 
TRIO: Our idea was like this: We will 
change the maximum number of colors 
as is physically possible. It will create a lot 
of complications (chuckling), but we'll 
deal with that somehow later. 

ANALOG: You want to implement the 
basic plan first, then work out the little 
rough spots. 

TRIO: Exactly. And there are plenty of 
them. 

ANALOG: And now you've got this work- 
ing. But with the amount of overhead and 
the tight timing, I imagine it would be 



difficult to do very, very complex anima- 
tion at this point, at the speed that the 
computer is running. 
TRIO: You never know. It certainly is an 
open question, but we think there is a 
good potential. 

ANALOG: How is Spectrum pro- 
grammed? Was it in C or what language? 
TRIO: It's Assembly. . . all Assembly. 

ANALOG: Do you think you could have 
pulled off the speed or the ability with 
any other language? 
TRIO: Well, some, I guess— 70% of it has 
to be done in Assembly. It's real-time 
alone. You have to know how long each 
instruction takes. 

ANALOG: The machine only goes so fast, 
you have to do it at the machine's full 
speed in order to do what you want to do. 
If you have the overhead of a compiled 
language, you won't be able to do it. 
TRIO: Yeah, in other programs when you 
use a high-level language, it will just slow 
down. Here, the picture will be destroyed 
(chuckle). 

ANALOG: In order to do the system tim- 
ing, you have to be able to go inside and 
run at the proper speed. 
TRIO: Yeah, some other parts of the pro- 
gram could have been done in . . . (pauses) 
but not too many of them, so better in- 
tegration on the whole thing, I guess. As- 
sembler is much richer in the number of 
instructions, and that gives you more. . . . 

ANALOG: More power? 
TRIO: To make that little machine work 
perfectly, you've got to beat the hell out 
of it, so you better go into the instruction 
level. To illustrate a little bit what I just 
said — as you can see when we made 
another step to [Digispec], what we did 
first, we really improved [Computer Eyes]. 
We gave them better abilities to use their 
own hardware, and then we jumped in 
and made another step further when we 
improved the software, which was possi- 
ble to pull from the Spectrum side. 

ANALOG: Can you expand a little bit on 
how Digispec came about? I realize that 
you approached the Digital Vision peo- 
ple because they had an existing digitiz- 
er, that, again, the market was there; there 
were a lot of people who had the product 
already. 

TRIO: First of all, we don't have anything 
exclusive with Digital Vision. At this 
point, well, their product is improved. 



pretty diversified. You got 
to know something about 
video images; you've got to 
know a lot about assembly. 
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Particularly, software-wise It doesn't mean 
that it's the best hardware available on the 
market, so we do have something in the 
works with other people, particularly 
working from scratch — combination 
hardware and software. So we think 
another digitizer could be done, although 
we don't have anything certain here. 

ANALOG: With regard to the Com- 
puterEyes digitizer: Did you dissect that 
the same way you did the computer by 
analyzing the actual hardware — to see 
what it could do? 

TRIO: They have specialized hardware. 
We didn't go into that. Not in the special 
hardware side. Starting with the video, the 
raw video data acquired, and what to do 
with it, we took over from that. 

ANALOG: You just used the device to pull 
it in; and basically once the data came in, 
you totally handled it differently than 
what they did originally. 
TRIO: Yes, absolutely. 

ANALOG: So, the hardware is the same, 
but you worked with them to have their 
software enhanced to a level that you 
could work with it. It improved their 
product; and also, now you have another 
branch on the tree — the Spectrum tree, 
we could call it — because you instantly 
have an application for the program. Peo- 
ple who have the digitizer now have a rea- 
son to buy your program. Or people who 
have the Spectrum program have a rea- 
son to buy the digitizer. It handshakes 
very nicely, doesn't it? 
TRIO: It's a. . .what they call these days, 
a popular expression: a "win-win" situa- 
tion. They win, and we win, and every- 
body wins. I think the user will win 
because you can see the result right there 
on the screen. Another thing we applied 
here, you've got to know simple things — 
simple from the physics standpoint — 
you've got to know optics, and we planned 
a few ideas from the area of optics. And 
that's how we improved their software too. 

ANALOG: In a way, by using the tech- 
niques you have, you've managed to 
smooth out the system's graphics that peo- 
ple would otherwise have considered inferi- 
or quality for doing certain types of 
displays. What this does is put into the 
hands of people with very inexpensive 
computers the power to do the kind of 
graphics work that normally costs a lot 
more 

TRIO: Oh, yeah (chuckle). 

ANALOG: For the small fee of a piece of 



software, users can now generate graph- 
ics of a quality that were impossible previ- 
ously. So do you see this as affecting ST 
sales potential? 

TRIO: The smoothing is done by in- 
troducing additional colors, so the abili- 
ty to have that many colors in one picture 
will probably affect the sales of the com- 
puters and everything else. Because you 
can do much more. 

ANALOG: At any rate, Spectrum again is 
a paint program, but now you have a ba- 
sis. Where do you expect to take it from 
here? 

TRIO: CAD 3-D. 

ANALOG: So you expect to work that in 
with some of the other products? 
TRIO: Yeah, we've had pretty good luck, 
I should say — talking about the market- 
ing side of the picture. We're pretty hap- 
py working with Antic. And we think that 
we can really improve their line of graph- 
ic products. From another hand, we can 
expand our own experience going with 
different types of hardware, and going to 
different kinds of applications like, for ex- 
ample, digitizers. That's another possibil- 
ity. The first step may be as some kind of 
an animation market, limited. Further 
down the road, we could make it availa- 
ble for some people, to a lot of developers. 

ANALOG: Is part of what attracted you 
to working with, in this case, The Catalog, 
that they are trying to make a broad-based 
graphics system with all these various 
parts? You have sort of fit in there, and 
you have people who have other parts 
conceived where eventually they can use 
your program. Because even if you can- 
not right now use Spectrum images with 
CAD 3-D, people will be expecting you to 
add that somewhere down the line. So you 
have a built-in market there, if you decide 
to do that. Is that part of the appeal? 
TRIO: Yes, I think that's the next thing 
to do. 

ANALOG: So you are going to license the 
technology for integrating with other 
products? It's not limited to your paint 
program or use with a digitizer. Do you 
think the process that went into 
Spectrum — of timing the computer and 
all — will enhance other people's work . . . 
and the ST market as a whole? 
TRIO: Absolutely. We're saying that [the 
ST is] a good machine. It has the poten- 
tials there, and we'd really like to partici- 
pate in expanding and improving, and 
have a much better user base. 



54 



August 1988 ST-Log 




The Atari ST Monthly Magazine 



Comdex '88. Atari and third party developers displayed 
business and productivity products at this large show. We 
have a complete report along with some interesting surprises. 

Opus. Not just the finest spreadsheet program ever 
published in a magazine for your Atari ST, but one of the best 
ever offered anywhere] Don't believe us? Check out the 
September issue. 

DEGAS Fast Loader. Turbo DEGAS Elite is what you'll get 
with this desktop utility. Now you can load compressed 
DEGAS pictures in no time at all. 

Start The Presses. A guide to desktop publishing with your 
ST. 

As well as our regular columns and new reviews. 
All in the September issue of ST-LOG. 



I 



by Ian Chadwick 



lAN'S 

QUEST 



was sorting out my hard disk the 
other day. It's a job I do irregularly, out 
of necessity when it becomes close to full. 
I back up everything, then remove a pas- 
sel of programs I don't use. While I was 
doing this, I realized that most of the programs on the disk are public domain — 
PD. That gave me pause to consider the whole business of freeware and shareware. 

Ever wonder about PD software? A whole lot of people out there work hours 
and hours and hours at writing the stuff to give it away. Sounds like poor business 
to me, but bless 'em all! Some of the most useful programs I own are PD. 

Who are the authors who spend their time slaving over a hot computer to give 
us these gems? Charles Johnson, David Betz, James Luczak, David Small, Frank 
Cohen, David Addison, Tim Purves, Jerry Cole, George Woodside and many, many 
more. Forgive me if your name isn't on the list. Many are hackers, but a lot of these 
people are professionals. It takes a lot of commitment to work that hard 
measurable reward. I think it's high time we said thanks! 

I guess we all take these programs for granted. After all, good or bad, we don't 
pay for them. Sure, some are shareware — that means the authors ask you to volun- 
tarily send them a donation. Sometimes this gets you an upgrade or enhanced 
version. Other times it just makes you feel good. I've never seen any figures on 
shareware; so I haven't the foggiest idea if anyone makes any money at it. Some- 
how, it looks more like a labor of love to me. 

But where would we be without PD programs? Online services like Delphi and 
CompuServe would be nothing mote than message systems. Ho hum. Some PD 
offerings are, truthfully, pretty much an amateur's effort; sort of a proclamation 
to the rest of us, "Hey! Look what I did!" But a lot are very well crafted, programmed 
and designed. And when source code is included, the user-support idea really 
makes the concept fly. 

Look at ST Writer, one of the best free programs I've ever seen and maybe tl 
best word processor for the ST at present. It came out as a port from the 8-bit 
Atari Writer. Version 2.52 is the latest (as of this writing), and it's terrific The printer 
drivers have been improved, it has mouse control and other new features; all thanks 
to the efforts of a dedicated bunch who get nothing beyond personal satisfaction 
for their services (and, of course, a good word processor). 

George Woodside's Turtle is another delight. I use it whenever I backup the hard 
disk. And where would we be without the PD archive/de-arc programs that con- 
dense files for transfer and storage? 

What about games? There are a fair number of good PD games out there. David 
Addison gave us Monopoly — as professional a game as I've ever en- 
countered — among others. And he provides the source code in GFA BASIC, so 
I can tinker to my heart's delight. PD games often include clones of popular com- 
mercial games which sell for inflated prices: Centipede, PacMan, that sort of thing. 
And in a lot of cases, the PD versions are even better than the originals. 

PD is also the showcase for a lot of new ideas. Many "hidden" features of GEM 
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and TOS have been revealed and exploit- 
ed first in PD programs. Some of these 
efforts show the most creative ideas I've 
encountered in the ST environment. 

There are many nifty utilities out there, 
at only the cost of the download time, 
that improve the computing environment 
considerably. There are programs to 
select which desk accessories to load, 
GEM item selector replacements, print 
spoolers, RAMdisks, replacements for 
desktop background and icons, printer 
drivers, graphics translators and more. 
There are paint and CAD programs, slide- 
show utilities, educational programs, 
spreadsheets, word processors, debuggers, 
disk copiers and sector editors, text edi- 
tors, databases, languages — so much 
material that you can get just about any 
type of program, application or utility 
you'll ever need in the PD world. 

This, of course, means that there is no 
excuse for piracy of commercial software, 
with so much good material available for 
free or very close to it. Then again, there 
never was any excuse for piracy. But that's 
another column. I was surprised to see 
how much material I had accumulated on 
my hard disk and how much of it was PD. 

ressed to remove a lot of it, 
since I use many of these programs. They 
don't merely consume space on my disk. 
I eve's a parochial problem: Canada. 
The question of software and maga- 
zine distribution up here has arisen so 
often that I thought I'd address it here. 

Where do Canadian stores get STLog 
or ANALOG? Up here, the magazine 
doesn't (yet) enjoy as wide a distribution 
as, sad to say, the competition. I've been 
asked many times by retailers where they 
an get the magazine locally. The answer 
is — I don't really know. But I've found one 
supplier who deals nationally: Micro D 
Distributors (not associated with the 
American company of that name). They 
also handle major software publishers. 
They can be reached in the Toronto 
region at 741-9825 or outside at 1 (800) 
387-5855. 

If you're in your local store (book, com- 
puter, software or magazine outlet), 
and they don't have ANALOG or STLog, 
ask them to start bringing it in. They can 
either call STLog/ANALOG in California 
for the name and phone number of a lo- 
cal distributor or call Micro D. 

I also wanted to mention Micro D be- 
cause they have been instrumental in 



providing me with review copies of 
software — something most distributors 
seem loathe to do. One of the problems 
of writing current reviews in the Great 
White North is that products, when they 
reach here, often arrive months behind 
the U.S. release, if they reach here at all. 
Many publishers don't have Canadian dis- 
tributors and a lot of their products sim- 
ply never get onto the shelves up here. 
And what does is pretty expensive. 

The problem has a lot to do with mini- 
mum order quantities (here comes 
the lesson, so take out your pens, there's 
a test afterwards). A publisher may de- 
mand a minimum order of, say five or ten 
copies to merit a dealer discount. Some-' 
times they only have one product (or one 
suitable for the dealer), and the dealer 
may not want that many copies of an un- 
tried product on his or her shelves. Or the 
item may be just a customer's special ord- 
er and no one else wants it. So they ord- 
er from a distributor who can mix titles 
for the minimum order and get the one 
copy, along with other items from other 
publishers. See? 

Without the dealer discount, the mar- 
kup on a product is hideous. Figure that, 
with our devalued Canadian peso, soft- 
ware is already 30% more expensive in 
Canada. Add tax, freight charges, distri- 
butor's markup and what have you, and 
the end result runs anywhere between 
50% and 100% markup. Here's a single, 
randomly chosen example: Michtron's 
great new product, GFA Artist, is $79.95, 
SLP in the USA. In Canada, it's $129.95. 
ST dealers up here aren't so numerous 
that they are highly price-competitive, so 
the pressure to discount is weak. Most 
stores don't discount these prices. That 
makes it very hard on the consumer. It 
discourages casual buying (who casually 
drops $60 or $75 for a game?) and en- 
courages piracy. 

What's the solution? I'm not offer- 
ing any. I don't know if there is 
one. I just thought I'd tell you this, to air 
the problem. If you come up with some- 
thing — let me know! 

Ian Chadwick is a technical writer and editor 
living with his wife in an igloo in Toronto, 
Canada. He is currently writing a murder mys- 
tery set in Mexico so he can claim travel ex- 
penses and designing a game on the campaigns 
of Napoleon so he can write off his book pur- 
chases. 
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continued from page 31 



GOSUB SCENTER: centers a line of 
small type (half size) 

GOSUB RCENTER: centers a line of 
regular type (default size) 

GOSUB LCENTER: centers a line of 
large type (1.5X) 

GOSUB XLCENTER: centers a line of 
extra large type (2X) 

Here is an example of the appropriate 
sequence: 

10 text$ = "GEMKIT SAVES WORK" 

20 TY=250 

30 GOSUB LCENTER 

GEMKIT text centering routines center 
text in the output window. This is not the 
true center of the screen. If you desire 
screen-centered text you should change 
the values assigned to the variable called 
rez, which can be found in the TYPESIZE 
subroutine. Appropriate values would be 
320 rather than 300, and 160 rather than 
150. The type size is automatically 
returned to the default after each text line. 

Writing mode determines the condi- 
tions under which text and graphics are 
printed to the screen. You may control, 
for instance, whether letters appearing on 
a patterned fill completely block out the 
pattern in and around the letters or 
whether the space around the letters is 
transparent and permits the fill to show 
through. 

The routines are: 

GOSUB BLANKOUT: replace mode, 
covers previous objects 

GOSUB TRANSPARENT: see-through 
mode 

GOSUB EXCLUSIVE: XOR mode, can- 
cels out where pixels conflict 

GOSUB REVERSE: white on black 
(transparent only) 

BLANKOUT and EXCLUSIVE are not 
called with their typical system names of 
replace and xor, because those are 
reserved words in ST BASIC. Writing 
mode will remain in the selected mode 
until explicitly changed to a new mode or 
back to the default mode. 

Graphics 

Three types of graphic elements that 
GEM refers to as bars may be called 
through GEMKIT. Essentially the bars are 
boxes of any size and shape in any screen 
location. 

To use the routines you must set x- and 
y-pixel coordinates for two corners of the 
box using variables called barxl and baryl 



GEMKIT 
■ 

for the first corner and barx2, bary2 for the 
second corner. Then use GOSUB to call 
for the type of box you desire. If you want 
a specific fill pattern in the box use the 
COLOR statement in ST BASIC before 
you call the bar shape with the GEMKIT. 
The ST BASIC Sourcebook contains a chart 
of the various fills available. 

GOSUB BAR: a filled box with square 
corners 

GOSUB ROUNDBAR: a filled box with 
round corners 

GOSUB HOLLOWBAR: unfilled box 
with round corners; ignores fill pattern 
set in COLOR statement 
Example: 

10 REM round cornered box with 
"Easter egg" pattern 

20 COLOR 1,1,1,17,2 

30 barxl =50:baryl =50:barx2 =300: 
bary2 = 90 

40 GOSUB ROUNDBAR 

Polymarkers are predefined graphic 
shapes that can be manipulated by select- 
ing screen locations, writing mode, colors 
and so on. GEMKIT has established four 
pro forma sizes for the polymarkers. Each 
of the sizes corresponds to one of the four 
available type sizes. There are six types of 
markers. 

GOSUB DOT: a one-pixel dot (size does 
not change) 

GOSUB PLUS: makes a + 
GOSUB ASTERISK: makes an * 
GOSUB SQUARE: makes a square 
GOSUB CROSSBUCK: makes a di- 
agonal cross 

GOSUB DIAMOND: makes diamond 
(horizontal orientation ) 

After calling one of the polymarker 
shapes, you must request a marker size. 
Pro forma sizes are as follows: 

GOSUB SMARK: makes marker one- 
half default type size 

GOSUB RMARK: makes marker 
default type size 

GOSUB LMARK: makes marker 1.5X 
default type size 

GOSUB XLMARK: makes marker 2X 



default type size 

You also must set x- and y-pixel coor- 
dinates for the location of the polymar- 
ker. The variables are "markx," "marky." 
Example: 

10 REM a double-sized diamond- 
shaped polymarker 

20 REM note that the shape is called 
before the size 

30markx = 40:marky =120: GOSUB 
DIAMOND: GOSUB XLMARK 

Polyline features allow you to deter- 
mine what lines drawn with BASIC pro- 
grams will look like. The two features 
available in GEMKIT are the width of the 
line and the types of ends on the line. 

GOSUB ENDSTYLE: sets one of three 
patterns for either or both ends of a line 

GOSUB LINEWIDTH: sets width of 
line in pixels 

To use GOSUB ENDSTYLE you must 
assign values to two variables (one for 
each end of the line) called leftend, right- 
end. For each variable: 0 = square end 
(default); 1 = arrow; 2 = rounded. 

Example: 

10 leftend = 2:rightend = 1: GOSUB 
ENDSTYLE 

20 REM sets linestyles so that the left 
end of a line will be round and the right 
end will be an arrow. 

To use GOSUB LINEWIDTH you must 
assign an appropriate value to a variable 
called linew. The values are integers in- 
dicating the number of pixels wide you 
want the line to be. Only odd numbers 
(such as 1,3,5,7 should be used). 

Example: 

10 linew = 5: GOSUB LINEWIDTH 
20 REM sets lines to 5 pixels wide 

There are two pro-forma dialog boxes 
available in GEMKIT. Each may be called 
with a one-word subroutine name. 

GOSUB FINISHED: ? in corner, 
message = "Finished?" yes/no buttons that 
may be clicked with the mouse, return key 
works with "no" 

GOSUB CONTINUE: ! in corner, 
message = "Click box or press RETURN", 
one response box = "CONTINUE" 

You also may design your own dialog 
boxes with GEMKIT. A variable called box$ 
is used to tell GEMKIT what graphic 
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feature you want in the dialog box corn- 
er, what message you want in the box and 
the number and messages in the response 
boxes to be clicked with mouse. 

To indicate which button will respond 
to a press of the return key, assign an ap- 
propriate value to a variable called return- 
box. You can have up to three buttons in 
a dialog box and they are numbered left 
to right. To call a dialog box use GOSUB 
DIABOX. 

Here's the syntax to create your own di- 
alog box: 

10 BOX$ = "[2][Will youlcontinue with 
your lesson?][YESINO]" 

20 returnbox = 2: GOSUB DIABOX 

In Line 10, you will note the dialog box 
is described in three parts set off in brack- 
ets. The number 2 in the first set of brack- 
ets tells GEMKIT to put a ? in the upper 
left corner. The three available graphics 
are 1=!; 2 = ?; 3 = stop sign. 

The second set of brackets contains the 
main message in the box. Note the use of 
the OR symbol (Shift + Backslash). It is 
used to separate lines of text in the box. 
You may have up to five lines, and the box 



grows to accommodate longer lines. 

The third bracket set contains the text 
to be included in the buttons. They also 
are separated by the Shift + Backslash 
symbol. Three is the maximum. GEMKIT 
knows how many buttons to make by 
checking for the number of OR symbols. 
Button text should be kept short, under 
20 characters total. 

Notice there are no spaces between the 
brackets. GEMKIT likes it that way and 
can return some strange looking dialog 
boxes if you aren't careful about that. 

Once the box is created it will be ask- 
ing you to make a choice from among the 
buttons. The variable that detects which 
button was clicked with the mouse (or 
return key) is called inbox. It reads the but- 
tons and numbers them from left to right. 

Using the example above: 

10 BOX$ = [2][Will you/continue 

with I your lesson?] [YESfNO] 

20 returnbox = 2: GOSUB DIABOX 

30 if inbox = 2 then goto 50 

40 REM "yes" would fall through to this 

line 

50 REM "no" jumps to this line 




Housekeeping features 

The title in the middle of the upper bar 
of the output window may be changed to, 
for instance, the name of your program. 
Assign the text you want to appear there 
in a variable called title$. The call GOSUB 
NEWTITLE. 

Example: 

10 title$ = "GEMKIT":GOSUB 
NEWTITLE 

Instead of a STOP or END statement 
to terminate program execution, use the 
call GOSUB GET.OUT. This isn't required, 
it's just a tidier way of leaving because it 
changes the name of the output window 
back to output. 

Improvements 

Aside from simply including more rou- 
tines, GEMKIT could be enhanced by 
creating more algorithms and user rou- 
tines that make using the GEM features 
of GEMKIT easier. Programming 
techniques — such as the one demonstrat- 
ed in the sampler for making menu selec- 
tions with the mouse — could make 
program development much faster. 



Gemkit — Listing 1 
ST Basic 

10 clearu 2:fullw 2:gotoxy 0,0 

20 TITLE$="GEHKIT SAMPLER" : GOSUB NEWT I 

TLE 

30 GOSUB 0UTLINE:TY=88:TEXT$= M A GEMKIT 

SAMPLER" : GOSUB XLCENTER 
40 TY=138:TEXT$="By": GOSUB XLCENTER 
50 TV=180:TEXT$="Gordon Bill ingsley" : G 
0SUB XLCENTER 

60 TY=218:TEXT$="press any key to cont 
inue": GOSUB LCENTER 

70 GOSUB NORMAL: TV=240 :TEXT$="Featur in 
g programing examples frort GEMKIT":G0 
SUB SCENTER 

80 CH$=INPUT$(1) iclearw 2:fullw 2 
90 GOSUB REUERSE:TY=88:TEXT$="M0USE CO 
NTR0L":G0SUB LCENTER : GOSUB BLANK0UT 
108 GOSUB B0LD:G0T0XY 3, 10 : ?"C1 ick lef 
t button to advance through pointer st 
yles" 

110 GOSUB UNDERLINE :gotoxy 3, ll:?"Clic 

k right button to continue with the Sa 

mpler demonstration" 

120 GOSUB NORMAL : P0 I NTER=8 

130 GOSUB READMOUSE : gosub show 

140 IF BUTTON-2 THEN 170 

150 IF BUTT0N=1 THEN P0IHTER=P0INTER+1 

!IF P0INTER>7 THEN POINTER=0 

168 G8SUB CHANGE : for 1=1 to 28:next:go 

to 138 

178 CLEARU 2 

188 COLOR 1, 1, 1, 17, 2:BARX1=38:BARV1=78 
:BARX2=40e:BARV2=288 

190 GOSUB R0UNDBAR : GOSUB BOLD : GOSUB TR 
ANSPARENT 

200 G0T0XV 2, 3:?"GEMKIT DIALOG BOXES A 
RE EASV TO CALL":G0SUB NORMAL 
218 G8SUB C8NTINUE 
228 CLEARU 2 

238 LINEW=25:G0SUB LINEWIDTH : RIGHTEND= 

1 : LEFTEND = 2 : GOSUB ENDSTVLE 

248 LINEF 28, 80, 500, 60 : GOSUB HATCH : G0S 



UB BLANK0UT 

250 TX=40:TV=184:TEXT$="THIS IS A P0LV 

LINE":G0SUB RTVPE 

260 GOSUB CONTINUE 

270 CLEARU 2 s FULLM 2: gosub nornal 

288 GOSUB DIAM0ND:narkx=28:narky=8B:go 

sub mark: GOSUB MARKC0UNT 

298 text$="START SAMPLER AGAIN" : tx=35 : 

ty=88:gosub LTVPE 

380 gosub DIAMOND :narkx=28 :narky=188 : g 
osub rnark: gosub narkcount 
318 text$="ST0P NOW" : tx=35 : ty=188 : gosu 
b LTVPE 

328 G8SUB FINGER 

338 gosub readnouse : GOSUB SHOW 

340 if Cny<narcy(i))*(ny>narcy CD-size 

nark)*Cbutton=l) then J=l:goto 378 

350 if (ny<narcy (2))*(ny>narcy C2)-size 

mark)*Cbutton=l) then J=2:goto 370 

368 goto 338 

378 GOSUB ARROW : on J goto 18,388 
388 clearw 2 : J=8 : gotoxy 8, 8:?"THAT'S A 
LL SHE WROTE." 
398 gosub get. out 

488 MARKCOUNT : P0LYMARKER=POLYMARKER+l 
418 MARCY (POLYMARKER) =MARKV: RETURN 
58888 ' ioociocxxxxmxxxxiooocxxxxwkxxmwmxx 
* 

58810 '* GEMKIT, version 1.1 
* 

58820 '« By Gordon Billingsley 
M 

50030 '* 
tt 

58848 '* Copyright 1987 

* 

50858 '* by ST-Log nagazine 

M 

58868 ' KMWMMMKXXMXKXKXMMWMXXMIIMMXXMXMIC 
* 

50878 ' 

58088 ' MMMKMXHMKKHXmiM 

50898 '** READMOUSE «* 

50188 ■ WKKKXXMXXXKKMMIt 
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5G118 REflDMOUSE : poke contrl, 124 

50126 poke contrl+2, 8:poke contrl+6,0: 

odisys (6} 

50138 nx=peek Cptsout) :ny=peek (ptsout+2 
) ■' ' xy coordinates 
50148 button=peekCintout) (RETURN 
58158 ' 

56168 1 WHHHHHHHHHHHHHHHHHHHHHHI 

58178 '** NEW POINTER SHAPES ** 

50180 1 MMKMMMMMMMMMMMMMMMMMMMMM 

58198 ARROW :pointer=0: gosub hide:gosub 

change:gosub showiRETURN 
58268 BEAN : pointer=l : gosub hide:gosub 
change:gosub showiRETURN 
58218 BEE : pointer=2 : gosub hideigosub c 
hange: gosub showiRETURN 
56228 FINGER:pointer=3:gosub hideigosu 
b change: gosub show: RETURN 
58238 HAND :pointer=4: gosub hidesgosub 
changeigosub show:RETURN 
58248 CR0SSHAIR:pointer=5:gosub hide:g 
osub change: gosub showiRETURN 
56256 FATHAIRipointer=6igosub hideigos 
ub change: gosub showiRETURN 
58266 H0LL0WHAIRipointer=7:gosub hide: 
gosub change : gosub showiRETURN 
56278 CHANGE : att=gb : gintin=peek Catt+8) 
56288 poke g int in, POINTER : gensys (78) : R 
ETURN 
56298 ' 

56388 ' MMMMMMMMMMMMMMMMMMMMMMMMMMMM 
58318 '** HIDE AND SHOW POINTERS ** 
56328 ' IHHHHHHHHHHHHHHHHHHHHHHHHHHHI 

56338 HIDE:poke contrl, 123 : vdisys CO) : r 
eturn 

50340 SH0W:poke contrl, 122 : vdisys CO) : r 

eturn 

56358 ' 

58368 ' 

56378 ' 

58386 ' xxxxxxxxxxx 
56398 'mm FONTS mm 
56486 ' xxxxxxxxxxx 
58416 NORMAL : F0NT=0 : GOTO NEMFACE 
50420 BOLD :F0NT=l: GOTO NEWFACE 
50430 HATCH :F0NT=2: GOTO NEWFACE 
50440 ITALICS:F0NT=4:G0T0 NEMFACE 
50450 UNDERLINE:F0NT=8:G0T0 NEWFACE 
50460 OUTLINE : F0NT=16 

50470 NEWFACE: POKE CONTRL, 106 : POKE CON 
TRL+2, 0 : POKE CONTRL+6, 1 
50480 POKE I NT IN, FONT : UDISVS CO) : RETURN 
50490 ' 

50500 ' XXXXXXXXXXXXKXXXXXXXXXXXXXXXWK 

50510 '** SELECTING NEW TVPE SIZES ** 
50520 ' xxxxxwxxxxxxxxxxxxxxxxxxxxxxxx 
50530 XLTVPE:SIZE=24:G0SUB TVPESIZE:G0 
TO PUT. TEXT 

50540 LTVPE:SIZE=18:G0SUB TVPESIZE:G0T 
0 PUT. TEXT 

50550 STVPE:SIZE=6:G0SUB TVPESIZE I GOTO 
PUT. TEXT 

50560 RTVPE:SIZE=12:G0SUB TVPESIZEiGOT 
0 PUT. TEXT 
50570 ' 

50580 ' xxxxwxxxxxxxxxxxxxxxxxxxx 
50590 'mm CHANGING TVPE SIZES mm 

50600 ' XXXXXXXXXXXXXXXXXXXXXXXXX 

50610 TVPESIZE :rez=300: if peekCsystab) 
=3 then rez=150 

50620 POKE CONTRL, 107 : POKE CONTRL+2, 6 : 
POKE CONTRL+6 1 

50630 POKE I NT IN, SIZE : UDISVS CO) : RETURN 
50640 ' 

50650 ' xxwxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

M 

50660 'm CENTERING TEXT IN FOUR SIZES 

M 

50670 ' XMXXXXXXXXXXXMXXXXXXXXXXXXXXXXX 
M 

50680 XLCENTER:size=24:gosub typesize: 
tx=intCrez-ClenCtextS)M8)) :goto put.te 
XT 

50690 LCENTER:size=18:gosub typesize:t 
x=int Crez- Clen Ctext$)M8) ) :goto put.tex 



t 

50706 RCENTER:size=12:gosub typesize.'T 
X=intCrez-ClenCtext$)M4)) :goto put.tex 
t 

56716 SCENTER:size=6:gosub typesizeitx 
=intCrez-ClenCtext$)M3)) igoto put. text 
50726 ' 

58738 ' XXXXXXXXXXXXXXXXXXXXXXKXXXXXXX 

56746 1 mm PRECISION TEXT PLACEMENT mm 

58758 ' XXXXWXXXMMXXXXXXXXXXXXXXXMXXXX 

58760 PUT. TEXT: long=len CtextS) 

50770 Poke contrl, 8 : poke contrl+2, 1 : po 

ke contr 1+6, long : poke contrl+12,2 

50788 for 1=B to long-1 

58798 letterx=asc Cnid$Ctext$, 1+1, 1)) 

58888 poke intin+l*2, letters 

58818 next I 

58828 poke ptsin, tx : poke ptsin+2, ty : wd 
isysCB) 

56838 size=12 : gosub typesize : RETURN 
58848 1 

56858 ' MMMMMMMMMMMMMMMMMW 

58860 'mm WRITING MDDE mm 

56878 ' xwxmxxxxxxxxxxxmwm 

58888 BLANK0UT :wnode=l : goto writenode 

50890 TRANSPARENT :wnode=2 : goto writeno 

de 

50900 EXCLUSIVE :wnnode=3 : goto writenod 
50910 REVERSE :wnode=4 

50920 WRITEMODE : poke contrl, 32 : poke co 

ntrl+2, 8 : poke contrl+6, 1 

50930 poke intin, wnode : wdisys CO) : RETUR 

N 

50940 ' 

50950 ' 

50960 ' 

50970 ' xxxxxxxxxxxxxxxxxxxxxxxxx 
56988 'mm BARS AND RECTANGLES mm 
58998 ' xxxxxxxxxxxxxxxxxxxxxxxxx 
51868 BAR : BARTVPE=1 : GOTO DRAWBAR 
51010 H0LL0WBAR : BARTVPE=8 : goto drawbar 
51020 R0UNDBAR:BARTVPE=9 
51030 DRAWBAR : POKE CONTRL, 11 : POKE C0NT 
RL+2, 2:P0KE CONTRL+6, 0 : POKE C0NTRL+10, 
BARTVPE 

51040 POKE PTSIN, BARX1 : POKE PTSIN+2, BA 
RV1 

51050 POKE PTSIN+4, BARX2:P0KE PTSIN+6, 
BARV2 

51060 UDISVS CO) I RETURN 
51070 ' 

51080 ' xxxxxxxxxxxxxxxxx 
51090 'mm POLYMARKERS mm 
51100 ' xxxxxxxxxxxxxxxxx 
51118 D0T:ntype=l:goto narkertype 
51120 PLUS:ntype=2:goto narkertype 
51130 ASTERISK:ntype=3:goto narkertype 
51140 SQUARE:ntype=4:goto narkertype 
51150 CR0SSBUCK:ntype=5:goto narkertyp 

51168 DIAMOND :ntype=6 

51170 MARKERTVPE : poke contr 1 , 18 : poke c 
ontrl+2, 0 : poke contr 1+6, 1 ■' poke contrl + 
12,2 

51188 poke intin, ntype: udisysCO) : RETUR 
N 

51190 ' narker height 

51280 SMARK:sizenark=12:goto narkersiz 
e 

51210 RMARK : sizenark=24 : goto narkersiz 
e 

51220 LMARKisizenark=36:goto narkersiz 

51230 XLMARK:sizenark=48 

51240 MARKERSIZEipoke contr 1, 19 : poke c 

ontrl+2, 1 : poke contrl+6, O.'poke contrl + 

12,2 

51250 poke ptsin, 8:poke ptsin+2, SIZEMA 
RKivdisysCO) 

51260 ' draw the narker 

51270 MARKER : poke contr 1, 7 : poke contrl 
+ 2,l:poke ptsin, MARKX I poke ptsin+2, MAR 
KV-INTCSIZEMARK/4) 
51280 vdisysCO) : RETURN 
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51298 ' 

51366 ' IHHHHHHHHHHHHHHHHHBHWHHtW 
51316 '** P6LVLINE END STYLE ** 

51328 ' MMWXKKKMMKKXXKKKKKKKMMICM 

51338 ENDSTVLE : poke contrl, 188 : poke co 

ntrl+2, 8 : poke contrl+6,2 

51348 poke intin, lef tend : poke intin+2, 

rightend: vdisysCB) : RETURN 

51358 1 

51368 ' WHHHHHHHHHHHHHHHHHBI 

51378 •** POLYLINE WIDTH ** 

51388 ' <HHHHMHHHHHHHBHHHHWm 

51398 LINEWIDTH : poke contrl, 16 : poke co 

ntrl+2, 1 :poke contrl+6,8 

51488 poke ptsin, 1 inew : poke ptsin+2, 8: 

vdisys(O) : RETURN 

51418 " 

51428 ' IHHHHHHHHHHHHHHHHW 
51438 '** DIALOG BOXES ** 
51446 ' MHHHHHHHBHHHHHHHHI 
51458 FINISHED:box$="[2] t|Finished?I [Y 
ES|N0]":returnbox=2:goto diabox 
51460 C0NTINUE:box$="[l] [|Click box or 
press <RETURN>] [CONTINUEl":returnbox= 
l:goto diabox 

51470 1 awaken the box 

51488 DIABOX : Att=GB : C0NTR0L=PEEK C flit 5 : GL 
0BAL=PEEK ( A»+4) 

51498 GINTIN=PEEKCA8+8) I GINT0UT=PEEK (A 
tt+12) : ADDRIN=PEEK (Att+16) 

51500 ' box contents 

51510 poke contrl, 122: poke contrl+2, 0: 
poke contrl+6, 1 : poke intin, 0 : vdisys (0) 
51520 Ntt=addrin:poke gintin, returnbox : 
poke ntt, varptr (B0X$1 :gensys(52) 

51530 1 box response 

51540 inbox=peek Cgintout) ivdisysCB) :RE 

TURN 

51558 1 

51568 1 

51578 1 

51580 ' IHHHHHHHHMHHHHHHHHHHHHHHHHHHHHHI 

51590 -MCHANGE TITLE IN OUTPUT WINDOW* 

51688 ' IHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHt 

51618 NEWTITLE:poke systab+24, 1 : alt = g 
b 

51620 gintin = peek Ca»+8) : poke gintin* 
8, peektsystab+8) 

51630 poke gintin+2, 2 : sJf = gintin+4:ti 

tle$ = title* ♦ chrSt8) 

51648 poke stt, varptr ttitle$) : gensys tl8 

5) 

51658 poke systab+24, 8 • RETURN 
51668 ' 

51678 ' jHHHHHHHHHHHHHBHHHHHI 
51688 '** LEAVING GEMKIT ** 
51698 ' IHHHHHHHHBHHHBHHHHHm 

51788 GET.0UT:title$="0UTPUT":gosub ne 
utitle : end 



Gemkit — Listing 1 
Checksums 

18 data 941, 672, 591, 841, 165, 959 
, 968, 175, 174, 478, 5948 

118 data 141, 568, 82, 993, 135, 699 
, 387, 821, 759, 759, 5336 

218 data 443, 374, 758, 61, 162, 458 
, 381, 769, 213, 878, 4489 

318 data 29, 92, 86, 185, 113, 488, 
37, 567, 317, 283, 2837 

418 data 872, 336, 378, 31, 896, 865 
, 596, 348, 662, 924, 5988 

58898 data 488, 989, 95, 74, 529, 53 
9, 659, 677, 672, 681, 5315 

58198 data 936, 536, 295, 759, 546, 
276, 998, 517, 513, 939, 6315 

58298 data 668, 45, 419, 49, 654, 71 
9, 661, 648, 665, 591, 5119 

58398 data 913, 576, 337, 878, 182, 



369, 842, 713, 884, 155, 5761 

58498 data 678, 173, 548, 177, 934, 
686, 787, 618, 667, 811, 5983 

58598 data 978, 796, 838, 811, 169, 
662, 352, 2, 356, 511, 5459 

58698 data 578, 559, 449, 659, 181, 
524, 185, 47, 299, 711, 4192 

58798 data 246, 451, 371, 966, 887, 

664, 178, 934, 182, 158, 4949 

58898 data 664, 517, 736, 262, 288, 

665, 652, 669, 813, 949, 6135 

58998 data 817, 389, 258, 225, 4, 34 
4, 638, 987, 665, 95, 4262 

51898 data 866, 88, 478, 722, 398, 9 
75, 427, 752, 514, 259, 5471 

51198 data 876, 346, 354, 352, 288, 
473, 784, 165, 716, 913, 5899 

51298 data 671, 678, 686, 674, 181, 
516, 664, 346, 253, 358, 5811 

51398 data 275, 164, 657, 171, 798, 
175, 561, 748, 39, 763, 4335 

51498 data 711, 871, 888, 223, 983, 
726, 666, 653, 678, 318, 6549 

51598 data 72, 383, 797, 784, 484, 6 
3, 785, 669, 351, 175, 4483 

51698 data 355, 485, 848 

GEMKIT 

END 




CircuitMakcr is a professional full featured 
program that enables you to design, construct and 
test an unlimited variety of digital circuits. Using 
CircuitMakcr, you eliminate the need to purchase 
breadboards, integrated circuits, wire and power 
supplies. CircuitMakcr allows you to design and 
test your digital circuits with just a few clicks of 
the mouse! 

CircuitMakcr is designed for the professional as 
well as the student that is just learning about digital 
logic. Circuit Maker is a must for your electronic 
projects! 

Only $79.95 

■ ■■ ■ P.O. Box 1144 

■ 495 West 920 North 
l#f 0rem > Utah 84057 
IUU (801) 226-3270 

Software Inc ° ffice hours 10:00AM-6:00PM MST 
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continued from page 1 7 

the sprite's screen position, you need to 
load the effective address of the sprite's 
definition block into address register AO. 
Finally, you must load the effective ad- 
dress of the sprite's background buffer 
into address register A2. Having done all 
this you simply call the DRAW_SPRITE 
function by using the word opcode label 
that you defined earlier. Here's an exam- 
ple of the process: 

MOVE 415C,D0 
MOVE »10G,D1 
LEA SPRITE1, A8 
LEA SPRITE1_BUF, A2 
DC.M DRAW- SPRITE 

The sprite definition block mentioned 
above is a block of continuous memory 
that contains a total of 37 words that 
describe the sprite's appearance on the 
screen. This definition block must con- 
tain the following information: 

Word 1 : X offset to sprite's hot spot 
Word 2 : Y offset to sprite's hot spot 
Word 3 : format flag (0=VDI format, 

l=XOR format) 
Word 4 : background color 
Word 5 : foreground color 

The next 32 words contain the desired 
sprite pattern. The pattern must be in the 
following order: 

Word 6 : background pattern of top 
line 

Word 7 : foreground pattern of top 
line 

Word 8 : background pattern of next 

line down 
Word 9 : foreground pattern of next 

line down 

The first two words of the sprite defi- 
nition block as mentioned above are the 
X/Y coordinates of the sprite's "hot spot." 
This coordinate set actually specifies the 
active point of the sprite. This is the point 
from which the sprite is drawn relative to 
when the DRAW_SPRITE opcode is 
called. The next word in the sprite defi- 
nition block, Word 3 is the format flag. 
This flag tells the DRAW_SPRITE rou- 
tine how to display the sprite's foreground 
and background in relationship to each 
other. The format flag usage is as follows: 

— VDI Format — 
FG BK Result 

0 0 The background (BK) appears. 

0 1 The color in Word 4 appears. 

1 0 The color in Word 5 appears. 
1 1 The color in Word 5 appears. 



— XOR Format — 
FG BK Result 

0 0 The background (BK) appears. 

0 1 The color in Word 4 appears. 

1 0 The pixel on the screen is 

XORed with the foreground 
(FG) bits of the sprite. 
1 1 The color in Word 5 appears. 

Words 4 and 5 of the sprite definition 
block as stated before specify the sprite's 
background color and foreground color, 
respectively. The background (BK), color 
for the sprites should be set to a value of 
0 or else the sprite will appear as your bit 
pattern design imprinted upon the top of 
a colored square. The foreground (FG) 
color can have any value between 1 and 
15 depending upon which screen resolu- 
tion you are currently using. The remain- 
ing 32 words of the sprite definition block 
contain the bit pattern for the image you 
want to display. Here's an example of a 
sprite definition block: 



SPRITEl: DC.U 8,1,0,0,1 
DC.M XOOOOOOOOOOOGOQOO 
DC.M XllllllllllllUll 
DC.M xOOOOOOOOOOOOOOOO 
DC.M Xllllllllllllllll 

XOOOOOOOOOOOOOOOO 

Xllllllllllllllll 

XOOOOOOOOOOOOOOOO 

xllllllllllllllll 
Koeoeoeoeeeeeoooo 

XlUiiOOOOOOllill 

XG0000O00O0OOO000 

mmooeeooiiiii 
dc.m Koooeeeeooooooooo 

DC.M XlUiiOOOOOOllill 
DC.M XOOOOOOOOOOOOOOOO 
XllillOOOOOOlllll 
KOO0OO0OOOOOOOOO0 
XllillOOOOOOlllll 
xOOOOOOOOOOOOOOOO 
XllillOOOOOOlllll 

XOOOOOOOOOOOOOOOO 

XllillOOOOOOlllll 
XOOOOOOOOOOOOOOOO 
XllillOOOOOOlllll 
DC.M X000OOOO00OO000OO 
DC.M Xllililliilllllll 
XOOOOOOOOOOOOO0O0 
Xllililliilllllll 
XO0OO0000OOOOOOO0 
Xllililliilllllll 
XOO00O00O000O0OOO 
Xllililliilllllll 



ott.u 

DC.M 
DC.M 
DC.M 
DC.M 
DC.M 
DC.M 
DC.M 



DC.M 
DC.M 
DC.M 
DC.M 
DC.M 
DC.M 
DC.M 
DC.M 
DC.M 



DC.M 
DC.M 
DC.M 
DC.M 
DC.M 
DC.M 



JX hot, V hot, Fornat 
;nl BK (Background) 
;»1 " 



FG 
SU2 BK 
;»2 FG 
,-83 BK 
;«3 FG 
Jtt4 BK 
;»4 FG 
;«5 BK 
;»5 FG 
;ttG BK 
;»6 FG 
;»7 BK 
197 FG 
;n8 BK 
;«8 FG 
;«9 BK 
;«9 FG 
;»io BK 
;>tie fg 
;«ii BK 
;ttll FG 

;ttl2 BK 
;ttl2 FG 
;nl3 BK 
;ul3 FG 
;ttl4 BK 
;»14 FG 
;ttl5 BK 
;ttl5 FG 
;»16 BK 
;»16 FG 



(Foreground) pattern 



flag,BK color, FG color 
pattern 



Now that we know how to put a sprite 
on the screen, we must be able to save the 
backgound behind the sprite so it can be 
put back once the sprite is moved. The 
sprite background buffer as mentioned 
earlier in this article does that very thing; 
it holds the background behind the sprite, 
so that when you move the sprite, the 
background beneath it can be restored to 
its original condition. This buffer must 
be 74 bytes long for high resolution, 138 
bytes long for medium resolution, and 
266 bytes long for low resolution. The 
difference is caused by the number of bit 
planes involved for the different screen 
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resolutions. In low resolution the ST's 
screen needs a total of four bit planes to 
display the 16 colors normally available 
at any given time in that mode. The 
medium-resolution screen requires only 
two-bit planes to display the four colors 
available in that mode, while the high- 
resolution screen needs only a one-bit 
plane to display the monochrome image 
it produces. The formula used to deter- 
mine the buffer length needed is 
N*64 + 10 where N is the number of bit 
planes. 

Here's an example for all three reso- 
lutions: 

SPRITEl-BUF: DC.B 74 ;high 
SPRITE1-BUF: DC.B 138 ;ned. 
SPRITEl-BUF: DC.B 266 Mow 

Once you know how a sprite is dis- 
played on the screen and how to save into 
a buffer its background for later use, all 
that's left to learn is how to use that buffer 
to restore the background behind the 
sprite to its original condition. The rou- 
tine used for this function is the Line A 
opcode $A00C, UNDRAW_SPRITE. This 
opcode has only one parameter. It is 
called simply by loading the effective ad- 
dress of the appropriate sprite's back- 
ground buffer back into address register 
A2. You then call the UNDRAW_SPRITE 
function by the word opcode label that 
you defined earlier in the program. 

In the demo program SPRITES, the IN- 
ITIALIZATION, DRAW_SPRITE, and 
UNDRAW_SPRITE functions are put 
into macro form. The format of these 
calls are as follows: 

LINE AI = $A000 :label the initiali- 
zation function 

DRAW_SPRITE = $A00D :label the 
Draw Sprite function 

UNDRAW_SPRITE = $A00C :label 
the Undraw Sprite function 

LINE_A_INIT :do the Initialization 
function 

MOVE_SPRITE X,Y,pointer to sprite 
definition block, pointer to the sprite's 
background buffer 

ERASE SPRITE pointer to the sprite's 

background buffer. 

The macro definitions themselves look 
as shown in Figure 1. 



These macros are optional. If you don't 
have a macro assembler like AssemPro or 
its equivalent then you will have to use 
the coding discussed earlier in this article 

The demo program SPRITES is set up 
to use the low-resolution screen of the ST, 
although it will work in medium resolu- 
tion. The program starts by drawing three 
stationary sprites of differing colors in the 
middle of the screen and two movable 
sprites in opposite corners of the screen. 
A prompt will then appear asking you to 
press any key to start the demo. After 
pressing a key, the two moveable sprites 
will begin to travel smoothly across the 
screen in opposite directions. They will 
continue to loop like that for about two 
minutes, and then you will be asked to 
press "X" to exit the program. 

The smooth sprite animation achieved 
in this demo is accomplished by using the 
XBIOS function #37, (WVBL). This built- 
in XBIOS function is very interesting; it 
waits for the next picture return to occur 
and then synchronizes the following 
graphic output to it, whatever graphic 
output that might be. In the demo pro- 
gram the WVBL call is made right before 
the sprite is erased, thus insuring a 
smooth look for the sprite's movement to 
its next position. Here's an example of 
WVBL call: 



MOUE.M 1137,- 
TRAP ttl4 
ADD.Q 112,8? 



(SP) ;UUBL function »37 
;Call XBIOS 
; Restore the stack 



(The demo program uses a macro for 
this function too. Since there are no 
parameters for this call all you have to do 
is put the WVBL call right before 
whatever graphics you want to syn- 
chronize with the picture return.) 

The following macro definition for 
WVBL was used in the demo program: 



UUBL -.MACRO 
MOUE.M B37, - 
TRAP al4 
ADDQ.L »2, SP 
ENDM 



(SP) ;XBI0S UUBL function 
iCall XBIOS 
iRestore stack 



Kelly Schreiner has been programming Atari's for 
approximately six years. He enjoys programming 
his 520 SI" in both 68000 machine language and 
Q and is currently studying to beco?ne an electronic 
engineer. 



LINE_A_INIT:MACRO 
DC.U LINE-AI ;do the INITIALIZATION function 

ENDM 

M0UE_SPRITE:MACR0 $M, SS2, SS3, S\4 



MOUE M.DB 
MOVE \2,D1 
LEA S3, AO 
LEA S4.A2 
DC.U DRAU-SPRITE 
ENDM 



;X position paraneter 
;V position paraneter 

.•pointer to the sprite definition block 
Jpointer to the sprite's background buffer 
Jdo the DRAU-SPRITE function 



OMNI-BANKER ST 




"Universal" MIDI Librarian 
for the Atari 520/1040 ST 

• Works as Desk Accessory and normal program 

• View entire banks of up to 128 named patches 

• Rename, audition, and drag patches within or 
between banks, using the mouse or keystrokes 

• Manage dozens of different synthesizers 

• Organize thousands of patches on a single disk 

• Inexpensive alternative to slow tapes, costly 
cartridges, and single-instrument librarians 

• Already supports over 60 instruments: 

23 Yamaha, 10 Roland, 8 Sequential, 6 Korg, 
5 Casio, 4 Siel, 2 Ensoniq, 2 Kawai, & more... 

• Expanding to support most current and future 
MIDI devices, with free updates issued quarterly 

• NOT Copy Protected; Mono or color monitors 

• No risk trial, 30 day money-back guarantee 

• Available now! Phone (616) 372-5972 




order direct from: 



K . . » Still Only... 

Paradigm § 55 

Software Products 

1369 Concord Place. Suite 3-B ™ s 
Kakrmazoo, Michigan 49008 Check/M.O. 
(Mich, resid. add 4% tax, foreign $10 S/H) 
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ERASE_SPRITE:MACR0 $\1 

LEA \1,A2 ;pointer to the sprite's background buffer 

DC.U UNDRAW- SPRITE Jdo the UNDRAU_SPRITE function 

ENDM 
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Sprite Programming — Listing 1 

Assempro 

Macro 

Assembler 



ILABEL TOSMOS.L 
GEM-INIT 



LINE-AI : 
UNDRAU-SPRITE : 
DRAU-SPRITE : 

US_C0LOR 

US-COLOR 

UST-EFFECTS 

UST-COLOR 

USL-COLOR 

USF-COLOR 

USF-INTERIOR 

USF-STVLE 

USF-PERIMETER 

U_HIDE_C 
U-CLRUK 



SAOOfl 
SAQ0C 
SA0OD 



GR_HANDLE, HO, BLACK 
GR_ HANDLE, ttl, BLUE 
GR_HANDLE, »4, D3 
GR_ HANDLE, ttl, D3 
GR_HANDLE,ttl, D3 
GR_HANDLE, ttl, D3 
GR_HANDLE, tt2, D3 
GR_HANDLE, ttl, D3 
GR_HANDLE, ttl, D3 

GR-HANDLE 
GR-HANDLE 



; Include TOS Library 
."Initialize GEM 

-■Label INITIALIZATION function 
,Label UNDRAU-SPRITE function 
.Label DRAU-SPRITE function 

JChange color 0 to black 

;Change color 1 to blue 

;Set text special effects to Italic 

;Set text color to 1 

;Set line color to 1 

;Set fill color to 1 

JSet fill style to dotted 

JSet fill index to 1 

;Set perineter fill visibility 

JHide cursor forn 
JClear screen 




UR-RECFL 

U-RBOX 

LINE_A_INIT 

U-GTEXT 

UST-COLOR 

U-GTEXT 



GR-HANDLE, TEST-BOX 
GR-HANDLE, FULL_SCREEN_BOX 



GR-HANDLE, 861, »59, MSG1 
GR-HANDLE, 83, D3 
GR-HANDLE, 037, tt25, MSG2 



MOUE-SPRITE 838,8188, SPRITE1, SPRITE8_BUF 
MOUE-SPRITE 8168,8180, SPRITE2, SPRITEO-BUF 
MOUE-SPRITE 8289, ttlOO, SPRITE3, SPRITEO-BUF 

MOUE 828, SIX 
MOUE 0300, S3X 

MOUE-SPRITE S1X,850,SPRITE1,SPRITE1_BUF 
MOUE-SPRITE S3X,8l58, SPRITE3, SPRITE3-BUF 
CONIN-ME 

MOUE 88, LOOP-NUMBER 
MAIN-LOOP: 

ADD .U ttl, LOOP-NUMBER 
START-LOOP: 

UVBL 

ERASE-SPRITE SPRITEl-BUF 
ERASE-SPRITE SPRITE3-BUF 
ADD .W tt2,SlX 
SUB.U tt2, S3X 

MOUE-SPRITE SIX, tt50, SPRITE1, SPRITEl-BUF 
MOUE-SPRITE S3X,8158, SPRITE3, SPRITE3-BUF 
CMP tt380, SIX 
BHI BACK-AGAIN 
JMP START-LOOP 

BACK-AGAIN: 
UUBL 

ERASE-SPRITE SPRITEl-BUF 
ERASE-SPRITE SPRITE3-BUF 
SUB.U tt2, SIX 
ADD.U U2 S3X 

MOUE_SPRITE S1X,«58,SPRITE1, SPRITE1_BUF 

MOUE-SPRITE S3X,«158, SPRITE3, SPRITE3-BUF 

CMP «28, SIX 

BLS MAIN-LOOP 

CMP 825, LOOP-NUMBER 

BEO FINIS 

JMP BACK-AGAIN 



Draw filled rectangle 

;Draw full screen outline 
Initialize Line A Opcodes 

Sprites nessage 
Set text color to 3 
Start nessage 

Stationary spritel 
Stationary sprite2 
stationary sprite3 

Moveable spritel's X position 

Moveable sprite3's X position 

Put noveable spritel on screen 

Put noveable sprite3 on screen 

Check keyboard 

Key pressed 

Set a loop counter 

Incrertent loop counter by 1 

Call XBIOS function 837 

Erase noveable spritel 

Erase noveable sprite3 

Add 1 to spritel X position 

SUB. 1 fron sprite3 X position 

Redraw noveable spritel 

Redraw noveable sprite3 

Is spritel's X position>300 

Ves, nove the other way now 

No, keep noving the sane way 

Move sprite other way 

Call XBIOS function 837 

Erase noveable spritel 

Erase noveable sprites 

Sub. 1 fron spritel X position 

Add 1 to sprite3 X position 

Redraw noveable spritel 

Redraw noveable sprite3 

Is spritel's X position<28 

Ves, do another full loop 

25 Full loops yet? 

Ves, check for exit deno 

No, do another full set of loops 



FINIS: 

MOUE-SPRITE SIX, 858, SPRITE1, SPRITE1_BUF 
MOUE-SPRITE S3X, 8158, SPRITE3, SPRITE3-BUF 
UST-COLOR 
U-GTEXT 



',D8 



CONIN-WE 
CMP.B 8'X',D8 
BEO OUT 
CMP.B 8'x 
BEQ OUT 
JMP FINIS 
OUT: 
U-SHOU-C 
UST-EFFECTS 
UST-COLOR 



JShow noveable spritel 
;Show noveable sprites 
GR-HANDLE, 82, D3 ;Set text color to 2 

GR_HANDLE,880,8188,MSG3 JExit nessage 

<Key pressed ? 
;ls it 'X' uppercase 
i Ves, exit deno progran 
;ls it 'x' lowercase 
JVes, exit deno progran 
ilnvalid key, check keyboard again 



GR_HANDLE, 88 ;Show cursor forn 

GR_HANDLE, 88, D3 ;Set text effects to nornal 

GR_HANDLE, 81, D3 JSet text color to 1 

GRAF-SHRINKBOX SCREEN_CENTER_BOX, FULI SCREEN-BOX, D3 ;Draw shrinking box 

GEM_EXIT ;Exit GEM 
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SPRI 
DC 
DC. 
DC 
DC 
DC. 
DC 
DC 
DC 
DC. 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC. 
DC. 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 



TEl: DC. 14 8,1,8,6,1 
M xB888e06BS8888088 
M Xllllllllllllllll 
U X88886868886B0Q8Q 
M Xliilllililililll 
M X8888088888888888 




M Xllllllllllllllll 
U X00OOO000O00000OO 
M Xllllllllllllllll 
U K88888888e8888088 
M X1111188686S11111 
M X888e868808888888 
U K1111188888811111 
M XB8888B888888B888 
M X1111188888811111 
M XB888B8868e888888 
M XlilllB8B6861ilil 
M X8BB8B888888BBBBB 
M K1111188888811111 
M X8B8B8BBB88B88688 
M X11111B8BB8811111 

u xseeeoeseeeeeeeee 
m xiiiiibbbbbbiiiii 

M X8666888888888888 

M X1111188886811111 

M XBBB8B08B68B8BBB8 

U Xllllllllllllllll 

U X000000O000000000 

M Xllllllllllllllll 

U X8868688888888888 

M Xllllllllllllllll 

M X888888e88888OOO0 

U Xllllllllllllllll 

TE2:DC.M 8,1,8,8,2 
M X8686888888888808 
U Xllllllllllllllll 
M X8886888888ee8888 
M Xllllllllllllllll 
U x8888B88888880e08 

u xiiseeasseeeeeen 

M X08888886G86OGOOO 
M Xll8e8ee886888811 
U xe888e88886886868 

m xiieeeeeeoseeeen 
m xeoooooo0ooo00ooo 

M X0000O11111100OQO 
M XQOO000G0O0Q00OQ0 

u xBeeeeiiiiiieoooo 

U y.OQOOOOQOOQOOOOOO 

m xoeeeeiiiiiieeeeB 
m xooooooooooooeooo 

M X0000011111106060 
M ^0000000000000000 
M X11O0OOOOOOO00011 
M XO0O0OOOOOOO0000O 
M X11OOOGO0G0000011 
M XOOOOOOOOOOOOOOOO 

u xiieeooooeooooon 

U y.0000000000000000 
U X11000O1111O00011 

u xeeeeeeiiiieeeeii 

M xllllllllllllllll 
U ^0000000000000000 
M Xllllllllllllllll 
M y.0000000000000000 

u xeeeeneeoiiieeee 



iSpritel definition block 
ttl BK (Background pattern) 
111 FG (Foreground pattern) 
82 BK 
82 FG 
S3 BK 
»3 FG 
84 BK 

84 FG 

85 BK 

85 FG 

86 BK 

86 FG 

87 BK 

87 FG 

88 BK 

88 FG 

89 BK 
89 FG 
818 BK 
818 FG 
811 BK 

811 FG 

812 BK 

812 FG 

813 BK 

813 FG 

814 BK 

814 FG 

815 BK 

815 FG 

816 BK 
816 FG 

;Sprite2 definition block 
81 BK (Background pattern) 

81 FG (Foreground pattern) 

82 BK 

82 FG 

83 BK 

83 FG 

84 BK 

84 FG 

85 BK 

85 FG 

86 BK 

86 FG 

87 BK 

87 FG 

88 BK 

88 FG 

89 BK 
89 FG 
818 BK 
818 FG 
811 BK 

811 FG 

812 BK 

812 FG 

813 BK 

813 FG 

814 BK 

814 FG 

815 BK 

815 FG 

816 BK 
816 FG 



SPRITE3:DC.M 8,1,8,8,3 

DC.M y.0000000000000000 ;»1 BK 

DC.U X110B886000000011 Jttl FG 

DC.M X888686680Q000080 ;«2 BK 

DC.M X1100800888888811 )»2 FG 

DC.M ^0000000000000000 ;83 BK 

DC.M ^1100000000000011 ;83 FG 

DC.M y.0000000000000000 ;n4 BK 

DC.M X1116868OQO8B0111 J84 FG 

DC.M y.0000000000000000 ;85 BK 

DC.M X1118800888880111 ;»5 FG 

DC.M X88ee888888880888 ;n6 BK 

DC.M X11100Q8808886111 ;»6 FG 

DC.M X0000OO00O0000O0O ;87 BK 

DC.M X1111BOOO08881111 J87 FG 



;Sprite3 definition block 
(Background pattern) 
(Foreground pattern) 
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dc.u xooooooeooooooooo 

DC.U X1111O0OQ0OO01111 
DC.U X8888B88888888888 
DC.U XlillOOOOOOOOllll 
DC.U £0000000000000000 
DC.U XllllllOOOOiillli 
DC.U XO00O0O000O00OO00 
DC.U Xllllllllllllllll 
DC.U X8888888888888888 
DC.U X8888888118888888 
DC.U X888888888B888888 
DC.U X8888881881888888 
DC.U X8888888888888B88 
DC.U X8888111881118888 
DC.U X8888888888888888 
DC.U X8811188888811188 
DC.U X0O00000O0000O00O 
DC.U X1188888888888811 



* M O 
' HO 


D V 


• ** O 

i ao 


rr 

ru 


* «♦ Q 
1*7 


BK 


« tt Q 
1 It 7 


r<- 

ru 




BK 


;«18 


FG 


j ttll 


BK 


jttll 


FG 


;«12 


BK 


;ttl2 


FG 


;»13 


BK 


;»13 


FG 


;»14 


BK 




rr 

ru 


;«15 


BK 


;«15 


FG 


;»16 


BK 


;jtl6 


FG 



SPRITE8-BUF: DS 

SPRITE1_BUF: DS 

SPRITE3.BUF: DS 

LOOP-NUMBER : DS 

SIX: DS 

S3X: DS 
FULL-SCREEN_B0X: 
SCREEN_CENTER_B0X 

MSGl: DC 

MSG2 : DC 

MSG3 : DC 

TEST-BOX: DC 

BLACK : DC 

BLUE : DC 
END 



B 266 
B 266 
B 266 
U 1 
U 1 
U 1 

DC.U 0,0,319,199 
DC.U 315,95,10,10 
B "ST Sprites really 
B "Press any key to 
B "Press 'X' to Exit 
U 20,30,300,169 
U 0,0,0 
U 0,0,1000 



; Non-Moving 
'Moveable s 
;Moveable s 
{Variable f 
;Uariable f 
;Uariable f 
; Coordinate 
'Coordinate 
work!", 8 ;Sprit 
start the deno", 
", 0 ; Exit nessa 
; Filled rec 
JColor blac 
;Color blue 



sprite 
pritel b 
prite3 b 
or loop 
or sprit 
or sprit 
s for fu 
s for sc 
es nessa 
0 ; Start 
ge 

tangle c 
k 



background buffer 
ackground buffer 
ackground buffer 
counter 
el X position 
e3 X position 
11 screen box 
reen center box 
ge 
nessage 

oordinates 



END 



HARDWARE ADD-ON 's for ATARI ST 



MEMORY upgrades: 

Solderless "plug in" installation, 1 year warranty 

520ST - expand to 1 , 2.5 or 4 MB on ONE board 

- prices start at $129 for the OK version - or go to 

1 MB only, $79 - without ram. 

1040/520STfm - upgrade to 2.5 and 4 MB, fully 

socketed, OK board $149. 

For all our memory upgrades: on board CLOCK 

module only $30 incl. software! 

For more detailed information phone or write to: 



iti( 



Co. 



1022 Hodgkins, Houston, TX 77032 
S (713) 590-2068 and 590-3738 



We ship COD or prepaid, sorry no credit cards! 
S/H on memory upgrades $5 
on Hard Drive Kits - $10/no drive - $20/w. dr. 
Texas residents add 8% state sales tax. 



EXPANDABLE 
Hard Drive Kits: 

1. 10" x 6.5" x 15" with full SCSI interface - 150 W 
PC power supply with fan - room for up to 5 half 
height drives - mounts on floor, under desk or on 
desktop - can supply power to 520ST and disk 
drives. 

kit with 40 MB full height 30 ms drive $745 

2. MEGA footprint, 3.7" high, 1-port SCSI Interface 
- room and power for 3 half height or 1 each full 
and half height drive, comes with fan 

kit with 10 MB half height drive $395 

3. 4.5" wide x 6" high x 13" deep with 1 port SCSI 
host adapter - ready for 2 half height or 1 full 
height - 55 W power supply, fan optional 

kit with 20 MB 1/2 height $485 

Atari 520ST, 1040St, 520STfm and MEGA are 
trademarks of ATARI Corp. 



CIRCLE #104 ON READER SERVICE CARD. 



continued from page 21 

function EUEHT : integer; 
var d: integer; 
begin 

repeat 

event : =get_event (e_button, 1,1, 1,8, false, 8, 8, 8,0, 

false, 8, 8, 8, B,nsg, d, d, d,nsx,nsy, d) ; 
until (nsy<191) and (nsy>18); 

end; 
{*PE*> 

function SEARCH-BOX (var dir: integer; cpx, cpy : integer) : integer; 
var i: integer; 
begin 

search_box:=8; 
do_sound(78, 3) ; 
delay (2); 
{path end?) 

if (n_box[cpx+la(dir, 1], cpy+la [dir, 21 1 1) or 

(n-boxtcpx+latdir, 11, cpy+la tdir, 21 ] =2) then 
begin 

search-box: =4; 
do_sound (158, 4) ; 
delay (2); 

end 
else 

{check for direct hit} 

if M_boxtcpx+laCdir, 11, cpy+la [dir, 21]=-99 then 
begin 

search-box :=l; 

for |lsi downto 1 do do_sound (i*18B, 2) ; 

end 
else 

(check for u-turn) 

if (n_box tcpx+la tdir, 31 , c py+l a [di r, 411 -99) and 

(n_box[cpx+la[dir, 5J, cpy+ latdir, 6)1 --99) then 
begin 

search-box: =2; 

for |lsf downto 1 do do-sound (i*18B, 2) ; 
for lis! to 9 do do_sound(i«188, 2) ; 

end 
else 

{change direction} 

if M_boxtcpx+la[dir, 31, cpy+la [dir, 41 1 =-99 then 
begin 

dir :=la(dir, 71 ; 
search_box:=3; 
do_sound (358, 4) ; 
delay (2); 

end 
else 

if n_box[cpx+la[dir,51, cpy+la [dir, 6] 1 --99 then 
begin 

dir :=la(dir, 81 ; 
search_box:=3; 
do_sound(558, 4) ; 
delay (2); 

end; 

end; 
{*PE*} 

procedure CLICK-OUT-BOX (px, py: integer) ; 
var sx, sy, f lag: integer; 
begin 

sx:=px; 
sy:=py; 

if (px+py>0) and (py-px<>9) and (px-py<>9) then 
begin 

n_box[px, py] ls2J 
draw-shape (px, py, pattern) ; 
pattern : =pattern+l; 
if pattern>24 then pattern:=9; 
if px=8 then dir ■ Si else 
if px=9 then dir:=2 else 
if py=8 then dir:=3 else 
if py=9 then dir (=4 J 
fUffsfl 
count:=B; 
repeat 

f lag: =search_box (dir, px, py); 
if (flag=B) or (flag=4) then 
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begin 

px:rp X +la tdir, 1] ; 
py :=py+la[dir, 2] ; 

end; 

if flag=l then 
begin 

draw_shape (sx, sy, 1) ; 
patterns =pattern-l; 

end; 

if flag=2 then 
begin 

draw_shape Csx, sy, 2) ; 
pattern : =pattern-l; 

end; 

if (flag=4) and (countM) then 
begin 

draw_shape (px, py, pattern-1) ; 
n_box [px, py] : =2; 

end; 

count s =t ount + 1 ; 
until (flagrl) or (flag=2) or (flag=4); 

end; 

end; 
(*PE*> 

procedure CLICK_IN_BOX (px, py: integer) ; 
begin 

do_sound(iee, 2) ; 

if (n2_box[px, py]=8) and (guess_nun<ski 1 l.level) then 
begin 

n2_box [px, py] : =-l; 
dr aw. shape (px, py, 3) ; 
guess-nun : =guess_nun+l ; 

end 
else 

if n2_box[px, py]=-l then 
begin 

n2_box[px, py] :=8; 
draw_shape (px, py, 26) ; 
guess.nun : =guess_nun-l; 

end; 

del ay (15); 

end; 
{*PE*> 

procedure DO-SCORE; 

war sc, i, j , k, px, py, click: integer; 

begin 

sc :=8; 

for i:=l to 8 do 
for j : =1 to 8 do 
begin 

do_sound (500, 5) ; 
delay (5); 

if (n_box(i, j]=-99) and (n2_box [i, j ] =8) then 
begin 

draw_shape (i, j , 25) ; 
do_ sound (700, 25) ; 
delay (5); 

do-sound (1288, 35) ; 

end; 

if (M-boxti, j]=-99) and (n2_box [i, j ] =-1) then 
begin 

draw-shape(i, j, 4) ; 

sc : =sc+l; 

for k:=l to 18 do 

begin 

do-sound (58, 4) ; 
delay (3); 
do_sound(288, 4) ; 
delay (3) ; 

end; 

end; 

end; 

if sc=skill_level then sc:=108 
else sc :=sc«trunc (188/ski 1 1. level) ; 
draw_shape (9, 8, 7) ; 

write (chr(27), ' V , chr (55) , chr (32) , sc) ; 

show_nouse; 

repeat 

c 1 ick : =event; 
px:=nsx div 32; 
py:=nsy div 28; 

if (px=9) and (py=8) then new_gane : =true; 
if (px=9) and (py=9) then quit:=true; 
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until quit or new.gane; 
hi de-nous e; 

end; 



{*PE*> 

procedure PL ft V_ GAME; 

var i, click, px, py, dunny : integer; 

begin 

pattern: =9; 
guess_nun:=8; 
new-gane : =f a 1 se ; 
quit:=false; 

write (chr(27J, , V,chr(55),chrC32), skill-level, ' '); 
repeat 

click:=event; 
hide_nouse; 
px:=nsx div 32; 
py:=(nsy-18) div 18; 
if py>9 then py:=9; 
if py<8 then py:=0; 

if Cpx=8) and (py=6) and (guess_nun=ski 1 l-level) then do.score 
else 

if px+p9<>18 then 

if (n_box(px, py]=l) then c 1 ick_out_box (px, py) 

else click_in_box(px, py) ; 

show-nouse; 

if (px=9) and (py=9) then quit: -true; 
until quit or new_gane; 

end; 
BEGIN 

for i:=B to 15 do 

desk-colorstil :=s_color C i , -1) ; 
if init-gen < 8 then 

button:=do_alert(' [11 [ CANNOT IHIT APPLICATION ][ SORRV ]',8) 
else 

if get-resOB then 

button :=do_alert(' 111 I Gane nust be run in LOU resolution ][ SORRV ]',8) 
else 
begin 

writefchr (7)1 ; 

init_nouse; 

hide_nouse; 

set-nouse (n_point_hand) ; 

clear_screen; 

show_nouse; 

txUis'Iill MERLIN" ' S BOX |'; 

txtfts 1 by Brian J Parry IE OK I'J 

txtl:=concat (txtl, txt2) ; 

button:=do_alert(txtl, 1) ; 

init-logic; 

init_palette; 

repeat 

hide-nouse; 

clear_screen; 

draw-board J 

show_nouse; 

skill-level :=get_skill; 

place-balls; 

p lay—Sana; 
until quit; 
set-nouse (n_arrow) ; 
exit_gen; 
for i :=8 to 15 do 
dunny :=s_color (i, desk.colorsli]) ; 

end; 
end. 
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Merlin's Box — Listing 2 
Assembly 



.globl STDRM 
STDRW: nove.l 



loopB: nove.l 
loopl: nove.l 



nove . 1 
adda. 1 
adda . 1 
dbf 



nove .w 
nove. 1 
asl 



nove . 1 
nove . 1 
nove . 1 



adda . 1 
adda . 1 
dbf 



lea 
adda 



(sp) +, retadr 
Csp)+, d6 
(sp) ♦, a5 
82, d8 
shptab, aB 
d0, aO 
Ca8),a4 
88, a3 
817, d6 
02, dl 

(a4, a3), (a5) 
84, a3 
84, a5 
dl, loopl 
Ca4, a3), (a5) 
84, a3 
8148, a5 
d8, loopB 



exit: nove.l 
rts 



retadr, -Csp) 



retadr: .del 1 

shptab : . dc . 1 si, s2, s3, s4, s5, s6, s7, s8, s9, s!8, sll, s!2, sl3, s!4, s!5, s!6 



.dc . 1 s!7, s!8, s!9, s28, s21, s22, s23, s24, s25, s2G, s27 



DC.L $3FFF3FFF, $3FFF8888, $FFFDFFFD, $FFFD88BB 

DC.L $1FFF1FFF, $1FFFCBB8, $FFFBFFFB, $FFFBB8BB 

DC.L $86888886, $1FFFE888, $88878887, SFFFF00O0 

DC.L $88888878, $1FF3EB68, $88878E87, $FE7F8888 

DC.L $88888868, $1FE7E888, $88878687, $FE7F8868 

DC.L $88888858, $1FD3E888, $68678A87, $FA7F0888 

DC.L $88888888, $1FF9E888, $88871887, $F3FF8888 

DC.L $88888881, $1FFFEB88, $88878887, S9FFF88B8 

DC.L $88888083, $1FFFE8B8, $BB87CB87, $CFFF8B8B 

DC.L $88688883, $1FFFE688, $88870887, $CFFF8668 

DC.L $68888881, $1FFFEB88, $88878867, $9FFF8866 

DC.L $88866868, $1FF9EB88, $86071887, $F3FF8668 

DC.L $68886856, $1FD3E886, $66878087, $FA7F8888 

DC.L $88888868, $1FE7E886, $66878687, $FE7F8688 

DC.L $88688878, $1FF3E888, $88878E87, $FE7F6686 

DC.L $88868866, $1FFFE688, $88878887, $FFFF6888 

DC.L $68888888, $8888DFFF, $88838863, $8683FFF8 

DC . L $88868688, $B888BFFF, $86816861, $B861FFFC 

* 2 by 18 words 



DC . L $3FFF3FFF, S3FFF8000, $FFFDFFFD, $FFFDBBBB 

DC.L $1FFF1FFF, 51FFFC800, $FFFBFFFB, $FFFB8BBB 

DC.L $80088818, $1FF3E0B8, $88878887, $FFFF6888 

DC.L $88868818, S1FF9E000, $08878887, $FFFF6868 

DC . L $000003FC, $1FFCE888, $O0077F87, $FF9F0686 

DC . L $015402AA, $1EAAE888, $55872A87, $2A9F8688 

DC.L S808083FC, 51FFCE888, $88877F87, $FF9FBBB8 

DC.L $81888298, $1E99E888, $81878287, $FE9F888B 

DC.L $88888398, $1F93E888, $88878387, $FF9F6888 

DC.L $81888288, $1E9FE888, $61878287, $FE9F6068 

DC.L $08688388, $1F9FE888, $88878387, $FF9F8008 

DC.L $01688288, S1E9FE888, $81678EE7, $FEE78O08 

DC.L $00888388, $1F9FE888, $886787C7, SFFCF8O00 

DC.L $81888288, $1E9FE888, $81876287, $FE9F8860 

DC.L $00886388, S1FFFE888, $88876167, $FF3F8800 

DC.L $06866888, S1FFFE008, $88878867, $FFFF8O06 

DC.L $08688888, S088BDFFF, $66838883, $8883FFF8 

DC.L $88888688, $8688BFFF, $88818881, $8BB1FFFC 

* 2 by 18 words 



DC . L $88878887, $88878807, $E8B8E888, $EB8BEB8B 

DC.L $80388038, $88388838, $1C881C88, $1C8B1C88 

DC . L $88C8B6C6, $B8C8B8CB, $03088388, $83800380 

DC.L $81868188, $81888168, $86888686, $88800880 

DC.L $82808288, $82000288, $88488848, $88488840 

DC . L $84888488, $84688486, $88288828, $86288828 

DC.L $04688488, $04080400, $00200020, $08200020 

DC.L $88888886, $88800888, $86166616, $68188618 

DC.L $88868888, $88886888, $88186816, $86188618 

DC.L $88868888, $88888888, $88188816, $88188818 

DC.L $88886888, $88888886, $88186818, $86188816 

DC. L $84888488, $84888468, $88288828, $88288626 

DC.L $84868468, $84608488, $68288828, $88268826 

DC.L $82666288, $82888286, $88468848, $88488848 

DC.L $81888188, $61688188, $88888888, $66888688 

dc.l soeceeecs, $eec88ece, $03000308, $63888368 

DC.L $88388838, $86386838, S1C881C88, S1C001C00 



« 2 by 18 words 
si 



s2 



s3 
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DC.L 
m 2 by 
s4 

DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 

* 2 by 
s5 

DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 

* 2 by 
s6 

DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 

* 2 by 
s7 

DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 

* 2 by 
s8 

DC.L 
DC.L 



$08870667, $88876887, $E888E888, $E8B8E888 
18 words 



$88888888, 
$88888887, 
SB88B803F, 
5888888FF, 

$eeeeeiFF, 

SBB8883FF, 
S8888B3FF, 
S8B8087FF, 
S8888B7FF, 
$BBBB87FF, 
$808887FF, 
S888883FF, 

$eeeee3FF, 
$eeee8iFF, 

$888888FF, 

$eeeee83F, 

$88888087, 
$00000000, 
18 words 

$00000888, 
$00000000, 
$00000000, 
$00000000, 
S1C711C71, 
S228A228A, 
$20822002, 
$20822882, 
$1C821C82, 
$82828282, 
$82828282, 
S228A228A, 
$1C711C71, 
$00000000, 
$00000000, 
$00000000, 
$00000088, 
$08000000, 
18 words 

$00000800, 
$00000000, 
$00000000, 
$88888800, 
$113E113E, 
$11281128, 
$11281128, 
$11201128, 
$1F3C1F3C, 
$11281128, 
$11281128, 
$11281128, 
$113E113E, 
$00000000, 
$00000000, 
$00000000, 
$00000000, 
$00000000, 
18 words 



$80000000, 
$00000000, 
$88888880, 
$00000000, 
$00000000, 
$00000000, 
$00000000, 
$00000000, 
$00000000, 
$00000000, 
$00008000, 
$00000000, 
$00000000, 
$00080000, 
$00000000, 
$00000000, 
$00000000, 
$00000000, 



$00000000, 

$oeeoEooo, 

$8888FC88, 
S8800FF88, 
S0B88FF88, 

seoeoFFce, 
$eeeoFFce, 

SBB88FFE8, 

$oeeeFFEO, 
seeeoFFEO, 

$8000FFE0, 
$ee08FFC8, 

$oeeeFFce, 

S8088FF8B, 
S08B8FF8B, 

$eeooFcee, 
$eoeoEoee, 

$00080000, 



$00800000 
$00000000 
$08800008 
$00800000 
$00000088 
$88888000 
$00600000 
$00000808 
$00000000 
$00800000 
$00880000 
$00800000 
$00000880 
$00000000 
$00608888 
$80666868 
$66886888 
$88686668 



$86888888, 
$86688888, 
$88888888, 
$88888688, 
S1C711C71, 
$228A228A, 
$28822882, 
$28822882, 
$1C821C82, 
$82828282, 
$82828282, 
$228A228A, 
$1C711C71, 
$86888686, 
$88888886, 
$68886686, 
$86688688, 
$68688866, 



$68868888, 
$68868888, 
$88688866, 
$88888886, 
SCF3ECF3E, 
$28A828A6, 
$28A828A8, 
$28A828A6, 
$2F3C2F3C, 
$2A282A26, 
$29282926, 
$28A828A8, 
SC8BEC8BE, 
$86888666, 
$88686868, 
$88868668, 
$86666666, 
$66886886, 



$68688688 
$86666866 
$68866886 
$68868688 
$CF3ECF3E 
$28A628A6 
$28A828A8 
S28A828A8 
$2F3C2F3C 
$2A282A28 
$29262926 
$28A828A8 
SC8BEC8BE 
$88668668 
$86888686 
$66668668 
$86688888 
$86866666 



$66666888, 
$88888888, 
$88888886, 
$88888888, 
$113E113E, 
$11281128, 
$11281128, 
$11281128, 
S1F3C1F3C, 
$11281128, 
$11281128, 
$11201120, 
$113E113E, 
$00000000, 
$00000000, 
$00000000, 
$00000000, 
$00000000, 



$00000000, 
$00000000, 
$00000000, 
$00000000, 
S48F84BFB, 
$40884888, 
$48884888, 
$48884888, 
S48F848F8, 
$48884886, 
$48884686, 
$48884886, 
$7C8B7C88, 
$68688888, 
$88888886, 
$68868888, 
$88888866, 
$88868688, 



$86668666 
$88888868 
$88886868 
$86888888 
S48F84BFB 
$48884888 
$48884888 
$48884888 
$48F848F8 
$46864888 
$48884888 
$48864888 
S7C8B7C88 
$66888868 
$88688886 
$88668888 
$88888868 
$86888686 



$68868888, 
$81178117, 
$81948194, 
$81946194, 
$81578157, 
$81348134, 
$81348134, 
$81178117, 
$88886888, 
$8E1C8E1C, 
$11221122, 
$18221822, 
$18221622, 
$133E133E, 
$11221122, 
$11221122, 
$6F228F22, 
$86666868, 
18 words 



$88868668, 
$81176117, 
$81948194, 
$81948194, 
$61576157, 
$81348134, 
$81346134, 
$81178117, 
$88868686, 
S8E1C8E1C, 
$11221122, 
$16221822, 
$18221822, 
S133E133E, 
$11221122, 
$11221122, 
SBF228F22, 
$86866668, 



$88888868, 
$C888C888, 
$68888886, 
$68886888, 
$88888888, 
$8A888A88, 
$8D886D88, 
SC88BC888, 
$88868886, 
$44F844F8, 
S6C886C8B, 
$54885488, 
$44884486, 
$44F844F8, 
$44884488, 
$44884488, 
$44F844F8, 
$88888688, 



$68888866 
SC88BC888 
$68888888 
$88888888 
$88888888 
$6A866A88 
SBD88BD8B 
SC888C888 
$68688868 
$44F844F8 
S6C886C8B 
$54885486 
$44884486 
$44F644F8 
$44884488 
$44884486 
$44F844F8 
$68686868 



$86888888, $66686688, $88688868, $68886688 
$86686868, $86888886, $68686668, $88888888 



ST-U.S.E. 

THE USED PROGRAM 
EXCHANGE FOR YOUR ST 

Trade Your Old Programs for 
Exciting New Titles 

Buy Quality ST Programs at a 
Fraction of the Original price. 

Over 250 Titles currently in stock 
New Arrivals Daily 

NOW SELLING NEW SOFTWARE 

Call or write today for a free price 
list and membership info. 

ST-USE 

314 Main Street 
Great Barrington, MA 01230 
(413) 528-4728 9 a.m. - 5 p.m. Eastern Time 
MasterCharge and VISA Accepted 



CIRCLE #111 ON READER SERVICE CARD 



New from the people who 
brought you IVlonitor IVI aster ! 




Are you tired of fumbling under or behind 
your computer to swap your mouse and joy- 
stick cables? Are your cable and computer 
connectors worn out from all the plugging and 
unplugging? Then Mouse Master is a must 
for you! 

*39.95* 



t 



Practical 
Solutions 



I930 E. Grant Rd.. 
Tuc/on. AZ 857I9 



* Retail price does not 
include shipping & handling. 



602 884 96I2 



CIRCLE #105 ON READER SERVICE CARD. 
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DC.L $86686688, $88888888, $66888888, $88868888 

DC.L $86888888, $88888688, $88868888, $88868888 

DC.L $8E228E22, $BE228E22, $7CF87CF8, $7CF87CF8 

DC.L $11221122, $11221122, $18281828, $18281828 

DC.L $11221122, $11221122, $18281828, $18281828 

DC . L $11221122, $11221122, $18281828, $18281828 

DC . L $11221122, $11221122, $18281828, $18281828 

DC.L $15221522, $15221522, $18281828, $18281828 

DC . L $15221522, $15221522, $18281828, $18281828 

DC . L $13221322, $13221322, $18281828, $18281828 

DC . L $8F1E8F1E, S0F1E0F1E, $7C287C28, $7C2B7C2B 

DC . L $88888888, $88888888, $88888888, $88888888 

DC . L $88888888, $88888888, $88888888, $88888888 

DC.L $88888888, $88888888, $88888888, $88888888 

DC . L $88888888, $88888888, $88888888, $88888888 

DC . L $88888888, $88888888, $88888888, $88888888 
« 2 by 18 words 
s9 

DC . L $3FFF3FFF, S3FFF888B, $FFFDFFFD, $FFFDBB8B 

DC.L $1FFF1FFF, $1FFFCB88, $FFFBFFFB, SFFFBBBBB 

DC.L $8BBB88BB, $88B8EB88, $88878887, $08670006 

DC.L $68888888, $886BE888, $88E788E7, S00E700E0 

DC . L $88888888, $0000E0O0, S83C783C7, $83C783C8 

DC.L $88888888, $0000E0O0, $87878787, $87878788 

DC.L $88888888, S6886E000, $88878887, $88878888 

DC.L $61AF81AF, $81AFE1AF, SFE87FE87, $FE07FEB8 

DC.L $87578357, $8357E357, $FEG7FE97, $FE97FEB8 

DC.L $87AF83AF, S83AFE3AF, SFE47FEA7, SFEA7FE00 

DC.L $81578157, S6157E157, SFE07FE07, $FEB7FEBB 

DC.L $88888888, $O000E000, $68878687, $86878688 

DC.L $66668686, $8ee6E8ee, $87878787, $87878788 

DC.L $66888668, $00OOE000, S83C703C7, $03C783C8 

DC.L $88688688, $6888E86e, $88E788E7, S0OE70OE0 

DC.L $88688688, $8000E0OO, $68878887, $88878868 

DC . L $66866866, S8800DFFF, $88838863, $8883FFF8 

DC.L $88868688, S000OBFFF, $86816861, SOOOiFFFC 

* 2 by 18 words 

sie 

DC.L S3FFF3FFF, $3FFF8868, $FFFDFFFD, SFFFD00OO 

DC.L S1FFF1FFF, S1FFFC000, $FFFBFFFB, SFFFB0OO0 

DC.L $88888888, $88e8E868, $88878887, $86878868 

DC . L $8888888C, S000CE000, $66878687, $86878888 

DC . L $88686884, $8884E888, $66678887, $88676868 

DC.L $8886880E, $0004E00A, $88878867, $68878888 

DC.L $6880008F, $808OE00F, $86876887, $86876888 

DC . L $0000088E, $OO00E00E, $66678687, $88876868 

DC.L S008O87FF, $88B8E7FF, $88B7F807, S0007F00O 

DC.L $88586FAF, $6888EFAF, $8007FF07, SOOO7FFO0 

DC . L S80280CD7, $0000EFD7, $6687FFF7, $0007FFF0 

DC.L $888007FF, $8868E7FF, $6887FF57, $8887FF5B 

DC.L $66888866, S800OE000, $68876687, $68678688 

DC.L $00000008, S0OO0E0O0, $00078007, $86878868 

DC . L $68688666, SO000E0OO, $68676887, $88676886 

DC.L $66888866, $8886E888, $88878867, $68878686 

DC.L $68886686, $68B8DFFF, $88836883, $8883FFF8 

DC.L $68686686, $8688BFFF, $88816881, S8881FFFC 

* 2 by 18 words 
sll 

DC . L S3FFF3FFF, $3FFF8868, SFFFDFFFD, SFFFD00O0 

DC.L $1FFF1FFF, $1FFFC688, $FFFBFFFB, SFFFB888B 

DC.L $68888666, $0000E0O0, $00070007, $00070000 

DC.L S000F000F, $686FE88F, $C887C887, SC007COO0 

DC . L $66336633, $8833E833, $38873867, $38673886 

DC . L $884C864C, $884CE84C, SC8B7C887, $C867C886 

DC . L $68CCeeCC, $eeCCE6CC, $CC67CC67, SCC87CC0O 

DC . L S8OB300B3, S80B3EBB3, $34673487, $34673488 

DC . L $88B3BBB3, S80B3E8B3, $34673487, $34873488 

DC.L SBBCCBBCC, $88CCEBCC, $CC67CC87, SCC87CC00 

DC . L $88CC6eCC, S08CCE0CC, SCC07CC07, $CC67CC86 

DC.L $66738673, $8873E673, $38873887, $38873800 

DC.L $88336633, $8B33E833, $36873687, $38873688 

DC.L $088F888F, $8eeFE80F, $C007C0O7, SC0O7C00O 

DC.L $88888668, $e888E888, $66876867, $88876886 

DC . L $86888686, $8868E8B8, $86876867, $88678868 

DC . L $80000008, $8886DFFF, $86838683, $8883FFF8 

DC.L $68688686, $868eBFFF, $88816881, S8O01FFFC 

* 2 by 18 words 
sl2 

DC.L $3FFF3FFF, $3FFF8B88, $FFFDFFFD, $FFFD088B 

DC.L $1FFF1FFF, S1FFFC688, SFFFBFFFB, SFFFBBBBB 

DC.L $66868688, $OO00E0OO, $00070007, $86878688 

DC . L $68618681, SO003EO01, $88878887, $C0078O00 

DC.L $66636663, $B81CE8B3, $00070007, SF8070000 

DC . L $8B8F886F, $8B78E88F, $68876687, $FE678888 

DC.L $681E881E, $88E1E81E, $07878787, SF807O7O0 
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DC.L 



DC 
DC 
DC 
DC 
DC 
DC 
DC.L 
DC.L 
DC.L 
DC.L 

* 2 by 
sl3 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 

* 2 by 
s!4 




DC 
DC 
DC 
DC 
DC 

DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 

* 2 by 
sl5 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 

* 2 by 
slG 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 



$68656085, 
$68888868, 
S815E815E, 
$B88E888E, 
$88648884, 
$88846864, 
$68866888, 
$88818681, 
$66888888, 
$88686688, 
$86888868, 
18 words 

$3FFF3FFF, 
$1FFF1FFF, 
$88866888, 
S8FFE8FFE, 
S8FFE6FFE, 
S8FC66FC6, 
$6FC68FC6, 
$8FFE8FFE, 
$8F1E8F1E, 
$8F1E8F1E, 
$6FFE8FFE, 
$8C7E8C7E, 
S6C7E8C7E, 
S8FFE8FFE, 
$8FFE8FFE, 
$88868888, 
$88868888, 
$88888888, 
18 words 

$3FFF3FFF, 
$1FFF1FFF, 
$88888888, 
S8FFE8FFE, 
$6DFA8DFA, 
$88FE88FE, 
S8AFE8AFE, 
$8FFE8FFE, 
$8FBE8FBE, 
$8F1E8F1E, 
$6F5E8F5E, 
S8FF66FFS, 
$8FE28FE2, 
$8BEA8BEA, 
$8FFE8FFE, 
$88886888, 
$88666886, 
$68868888, 
18 words 

S3FFF3FFF, 
S1FFF1FFF, 
$86888888, 
$66888886, 
$888E86eE, 
$681E861E, 
$84688486, 
$88688886, 
$68668868, 
$82738876, 
$618C8888, 
$888868A8, 
$88886888, 
$86768878, 
$88668886, 
$86888868, 
$66868888, 
$86868886, 
18 words 

S3FFF3FFF, 
$1FFF1FFF, 
$86886888, 
$68846864, 
$88628882, 
$66888888, 

$88FFeeee, 

$68FF8eiF, 

$eeE8ee2e, 

$eeC46844, 
$88098049, 
$86D28852, 



$61FAE865, 
$81F7E868, 
$88A1E15E, 
$8171E88E, 
$88FBE884, 
$687BE684, 
$B81FE888, 
$B863E8ei, 

$B886Eeee, 

$888BDFFF, 
$B888BFFF, 



$1F871F87, 
$67876787, 
$1C871C87, 
$3C673C87, 
$38673887, 
$88878887, 
$88878887, 
$88878867, 
$88878887, 
$68838883, 
$88816861, 



$E8871F88 
SF8878789 
$E3871C88 
$C3873C68 
$C7873868 
$F6878888 
$F8876888 
$08878886 
$88878688 
$8883FFF8 
$8881FFFC 



$3FFF8eee, 
$iFFFceee, 
seeeeEeee, 

$8FFEEFFE, 
$8FFEEFFE, 
S8FC6EFC6, 
S6FC6EFC6, 
$8FFEEFFE, 
$8F1EEF1E, 
$8F1EEF1E, 
$8FFEEFFE, 
$8C7EEC7E, 
$6C7EEC7E, 
$8FFEEFFE, 
$6FFEEFFE, 

$eeeeE8BB, 

$8888DFFF, 
S8886BFFF, 



SFFFDFFFD, 
SFFFBFFFB, 
$88876867, 
$7FF77FF7, 
S7FF77FF7, 
$47174717, 
$47174717, 
S7FF77FF7, 
$78F778F7, 
S78F778F7, 
$7FF77FF7, 
$47174717, 
$47174717, 
$7FF77FF7, 
$7FF77FF7, 
$88878887, 
$88838883, 
$88818881, 



$FFFD6668 
SFFFB6668 
$88876888 
$7FF77FF8 
S7FF77FF8 
$47174716 
$47174718 
S7FF77FF8 
$78F778FB 
S78F778FB 
S7FF77FFB 
$47174718 
$47174718 
S7FF77FFB 
S7FF77FFB 
$88876888 
$8883FFF8 
$8881FFFC 



$3FFF8888, 

siFFFceee, 

$8e86E888, 
S8FFEEFFE, 
SBDFAEDFA, 
$88FEE8FE, 
$6AFEEAFE, 
$6FFEEFFE, 
$8FBEEFBE, 
$8F1EEF1E, 
$8F5EEF5E, 
$8FF6EFF6, 
$8FE2EFE2, 
$8BEAEBEA, 
$6FFEEFFE, 
$8868E888, 
$8886DFFF, 
S8888BFFF, 



$3FFF8866, 

siFFFceee, 

S8888E886, 
S888FE688, 
$881FE8BE, 
S883FE81E, 
$87FFE466, 
$87FFE68e, 
S878FE888, 
S8878E878, 
S8888E888, 
S88A8E888, 
S8888E888, 
$8878E878, 

seeeeEeee, 

$8868E8ee, 
$8888DFFF, 
S8888BFFF, 



$3FFF8686, 

$iFFFceee, 

S8888E888, 
$8884E884, 
S8883E882, 
$8883E888, 
S88FFEBFF, 
S88E8E8FF, 
$86C8E8E6, 
$8684E8C4, 
S8889E8C9, 
$8B92E6D2, 



SFFFDFFFD, 
SFFFBFFFB, 
$88876867, 
S3FF73FF7, 
$3FF737B7, 
S3FF72317, 
$3FF737B7, 
$3FF73FF7, 
S3FF73EF7, 
S3FF73C77, 
$3FF73EF7, 
$3FF737B7, 
S3FF72317, 
S3FF737B7, 
$3FF73FF7, 
$66676887, 
$88638663, 
$66618661, 



SFFFDFFFD, 
SFFFBFFFB, 
$66678687, 
$6887C887, 
$46674667, 
$46874687, 
$66876687, 
$88876667, 
$66676667, 
$8E476E87, 
$71871167, 
$11671567, 
$11871167, 
$6E876E67, 
$68676867, 
$66676887, 
$66836863, 
$68616661, 



$FFFD8886 
SFFFB8888 
$68878686 
$3FF73FF6 
$37B737B8 
$23172316 
$37B737B8 
S3FF73FF8 
S3EF73EFB 
S3C773C78 
$3EF73EF8 
S37B737B8 
$23172318 
S37B737B8 
S3FF73FF6 
$88876666 
S8883FFF8 
S8881FFFC 



SFFFDB888 

sFFFBeeee 

$88878666 
508978888 
$08874888 
$08874888 
$FFF7888B 
$FFF78888 
SF1F78BB8 
S8E878E88 
$11871168 
$15871166 
$11671186 
$8E878EB8 
$66876886 
$88876666 
$8683FFF8 
$6681FFFC 



SFFFDFFFD, 
SFFFBFFFB, 
$16871667, 
$28872667, 
$48874667, 
$86676887, 
$FF676887, 
SFF87F887, 
$67676487, 
$8B678A67, 
$13871287, 
$23872287, 



SFFFD8B88 

SFFFBeeee 

$16671886 
$26672866 
$C6874688 
$08876688 
$FF67FF66 
$67B7FF6e 
$63678766 
$89B78B88 
$11671368 
$21872368 



August 1988 ST-Log 



73 



DC . L S0BE8B826, SOOCOEOEO, $87878487, $03870788 

DC.L S00FF085F, S00E0E0FF, SFF07FA07, $8707FF00 

DC.L S00FF0000, $88FFE8FF, SFF070007, $FFB7FF00 

DC.L $08888888, $e888E888, $88878887, $80878008 

DC . L $88888888, $8888DFFF, $88838883, S8863FFF8 

DC.L $88888888, $8888BFFF, $88818881, $8801FFFC 

* 2 by 18 words 
ml? 

DC.L $3FFF3FFF, $3FFF8000, $FFFDFFFD, SFFFD88B8 

DC . L S1FFF1FFF, $1FFFC88B, SFFFBFFFB, $FFFBBB88 

DC.L $88008008, $8888E88e, $08878887, $BB878B8B 

DC.L S01C00000, $01C0E0O8, $03870007, $03870000 

DC.L S03F00000, S03F0E000, $0FC70007, $0FC7O00O 

DC.L $87FC8888, $07FCE000, S3FE70007, $3FE7O000 

DC.L $87FE88B8, $07FEE00O, S7FE70007, $7FE70000 

DC . L $0FFF8B81, S8FFFE881, $FFF78887, $FFF78B88 

DC.L $0FFFO882, $0FFFE002, SFFF74007, SFFF74000 

DC.L S0FFF0002, S0FFFE002, $FFF74007, SFFF74000 

DC.L $0FFF0001, SOFFFE0O1, SFFF78B87, $FFF78888 

DC.L S07FE0000, $07FEE0OO, S7FE70O07, $7FE70000 

DC.L $87FC88BB, S07FCE00O, $3FE70007, S3FE70OO0 

DC.L $03F088B8, S03F0E000, $0FC70007, $OFC700O0 

DC.L $01008888, $81C8E888, $03870007, $03870000 

DC.L $00000888, S0000E000, $00878887, $86878888 

DC.L $88888888, $8688DFFF, $00030003, $0003FFF8 

DC.L $88888888, S0000BFFF, $88816881, $8881FFFC 

* 2 by 18 words 
sl8 

DC.L S3FFF3FFF, $3FFF8888, $FFFDFFFD, $FFFD000O 

DC.L S1FFF1FFF, $1FFFC0O0, SFFFBFFFB, $FFFBB8B8 

DC.L $88888888, $BBBBE88B, $00070007, $00870000 

DC.L $02448244, $8244E244, $00070007, $00870000 

DC.L $02248224, $8224E224, S01E701E7, S000701EO 

DC.L $81488148, $8148E148, $87E7B7E7, S800707E0 

DC.L $00000000, $O00OE0O0, $0E070E07, $0O870EOO 

DC.L $02188218, $81EBE3F8, $38873887, $68073888 

DC.L S87F887F8, $8888E7F8, $70077007, $00077000 

DC.L S07F907F9, $8888E7F9, $C007C007, S0O07C00O 

DC.L $87FF87FF, $0008E7FF, $86878887, $88878868 

DC.L $87FF87FF, $0000E7FF, $88878887, $88878668 

DC.L $87FC87FC, $8888E7FC, $00070007, $00070000 

DC.L $83F883F8, $0888E3F8, $00070007, $00070000 

DC.L $88888888, $888BE888, $00070007, $00070000 

DC.L $08888888, S0000E000, $88878887, $88876888 

DC.L $88888888, $8888DFFF, $00030003, $0003FFF8 

DC.L $88888888, $8B88BFFF, $00010001, $00O1FFFC 

* 2 by 18 words 
sl9 

DC.L $3FFF3FFF, $3FFF8888, SFFFDFFFD, SFFFD0000 

DC.L S1FFF1FFF, $1FFFC000, SFFFBFFFB, $FFFBO0O0 

DC.L $00000000, $8800EOO0, $88878887, $88678888 

DC.L $88688888, S0000E000, $00070007, $00070000 

DC.L $00600060, $0068E868, $00070007, $00070000 

DC.L $01F3O0O3, $0OO3E0O3, $FFF7FFF7, SFFF7FFF0 

DC . L $82308882, $0O02EO82, SAAA7AAA7, $AAA7AAA8 

DC . L $623F8888, S0000E000, $FFE700O7, $00070000 

DC . L S03FF0000, SeeeOEOOO, $FFE70O07, $00070000 

dc . l $83FAeeee, seeeoEeee, $bfa788B7, $86878888 

DC.L $87FF84E8, $04E0E4E8, $FFF70737, $07370730 

DC.L $071F8517, S05F7E5F7, SF8F7E8B7, SEFB7EFB8 

DC . L $81188118, $81F8E1F8, $08878887, $8F878F88 

DC.L $0OEO8BE8, S06E0E0E0, $07070707, $07070700 

DC.L $00000000, $O0O0EOO0, $00070007, $00070000 

DC.L $00888888, $8888E888, $00070007, $00070000 

DC . L $80000000, $0888DFFF, $00030003, $0003FFF8 

DC . L $00000000, $OO00BFFF, $00010001, $O0O1FFFC 

* 2 by 18 words 
s28 

DC.L S3FFF3FFF, $3FFF8888, SFFFDFFFD, SFFFD8888 

DC.L S1FFF1FFF, S1FFFC888, SFFFBFFFB, SFFFB8888 

DC.L $88888888, $O00OE00O, $00070007, $00070060 

DC.L $00030003, SOOO3E003, $E0O7E0O7, $E007EOe0 

DC.L $00040004, $0004EOO4, $10071007, $10071000 

DC.L S0000000F, SOeOOEOOO, $0007F887, $8BB78888 

dc . l seeeeeesF, seeeoEooe, $o0O7feo7, $00070000 

DC . L SOOOOOOFF, SOOOOEOOO, $0e07FF87, $86876800 

DC.L $O02A81EA, $002AE02A, SAA07AAC7, $AA07AAO0 

DC . L SOOOOOOFF, SOOOOEOOO, S0007FF87, $88878888 

dc . l S0O000O3F, sooooeooo, $ooo7feo7, $00070000 

DC.L SOOeeeeOF, SOOOOEOOO, $00077887, $88878888 

DC . L $88888828, S0000E000, $00078287, $88876888 

DC . L $88888848, $8888E888, $00078187, $88878888 

DC.L S60OOO1C1, SOOOOEOOO, S0007C1C7, $00070000 

DC . L $00000000, SOOOOEOOO, $00070007, $00070000 

DC . L $00008888, $B888DFFF, $00030003, S8883FFF8 
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DC.L 
» 2 ba 
s2i 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 



$88866800, $88B8BFFF, $88810881, SO001FFFC 
18 words 



DC 
DC 
DC 
DC 
DC 
DC 

DC.L 
DC.L 
DC.L 
* 2 by 
s22 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 




DC 
DC 
DC 
DC 
DC 
DC 
DC 

DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 

* 2 by 
s23 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 

* 2 by 
s24 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 



DC 
DC 
DC 
DC 
DC 
DC 

DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
* 2 by 
s25 
DC.L 
DC.L 



S3FFF3FFF, 
$1FFF1FFF, 
$88888860, 
$88888887, 
$8886883F, 
$B88688FF, 
$888861F9, 
$8B8883F9, 
$688883FF, 
$00O0O3DF, 
$8680839F, 
$8BBB61E7, 

$8eeeeeF8, 

$0068883F, 
$88888887, 
$88888886, 
$88888888, 
$88888808, 
18 words 

S3FFF3FFF, 
S1FFF1FFF, 
$88888880, 
$88018881, 
$88878887, 
$881F081F, 
$067F887F, 
S81FF81FF, 
$887F6848, 
$88636650, 
$66636850, 
$88638850, 
$067F8e46, 
$007F0840, 
$887F8B7F, 
$66888868, 
$68880880, 
$80000000, 
IS words 

$3FFF3FFF, 
$1FFF1FFF, 
$00000088, 
$68C88888, 
$81A08888, 
$81208888, 
$86086666, 
$83348851, 
$04A48841, 
$85980140, 
$03000044, 
$00000324, 
$00000130, 
$00000190, 
$00000330, 
$00000600, 
$00000666, 
$68888888, 
18 words 

$3FFF3FFF, 
$1FFF1FFF, 
$88800000, 
$00060000, 
$O1C601C0, 
$B3E882E8, 
$03E68388, 
$83E881E8, 
$81086808, 
$68668666, 
$60000868, 
$66616668, 
$66876683, 
$881E8686, 
$06608680, 
$08668888, 
$88666668, 
$88888888, 
18 words 



$3FFF8888, 
$1FFFC888, 

seeeeEeee, 

$8B67E88e, 
$8B3FE8B8, 
$88FFE8B8, 
$81F9E8B8, 
$B3F9E88B, 
$83FFE8BB, 
$83DFE88B, 
$639FE8B8, 
$81E7E88B, 
$8BF8E88B, 
$e63FE886, 
$8B87E888, 
$8888E688, 
$8868DFFF, 
$8868BFFF, 



$3FFF88B8, 
$1FFFC88B, 
$8B8BE88B, 
$8881Eeei, 

$eee6E687, 

$8618E81F, 
$866eE87F, 
S81FFE1FF, 
$B848E84e, 
$B84BEe5C, 
S6840E05C, 
$8648E05C, 
$e846E84B, 
$8B48E84B, 
$8B7FE87F, 
$88B8E888, 
$B8B8DFFF, 
$88BBBFFF, 



$3FFF8BBB, 
$1FFFC88B, 
$0000E800, 

seeceEeee, 

$eiA6E88e, 

$ei26E8ee, 

$88D8E886, 
$8335E818, 
SB4A5E880, 
$B598E188, 
$B38BE88e, 

seeeeEeee, 

$6888Ee86, 

seeeeEeee, 
seeeeEeee, 
seeeeEeee, 

$8686DFFF, 
$8888BFFF, 



S3FFF8888, 
S1FFFC888, 

seeeeEeee, 
seeeeEeee, 

S81C8E1C6, 
S82E8E2E8, 
$B3BBE366, 
S81E6E1E8, 

seeceEeee, 
seeeeEeee, 
seeeeEeee, 

S6881E661, 
$8684E887, 
S8618E01E, 

seeeeEeee, 
seeeeEeee, 
seeeeDFFF, 

S8860BFFF, 



SFFFDFFFD, 
SFFFBFFFB, 
$88076067, 
SB667E687, 
$Be07FCe7, 
$ee07FF67, 
S06679F87, 
SB6679FC7, 
S8867FFC7, 
S8887FBC7, 
SB667F9C7, 
S8687E787, 
SB6871FB7, 
$B8B7FC87, 
S6687E867, 
$66878807, 
$80038803, 
$66818801, 



SFFFDFFFD, 
SFFFBFFFB, 
$06876687, 
$86678667, 
$E667Ee67, 
SF887F8B7, 
SFEB7FE87, 
SFF87FF87, 
SFE878267, 
SFE878287, 
SFE07FA07, 
SFE07FA07, 
SFE07FA07, 
SFE67FA87, 
SFE87FE87, 
$86678687, 
$68838883, 
$88818881, 



SFFFDFFFD, 
SFFFBFFFB, 
$66678887, 
$60670067, 
$68671287, 
$06071267, 
S6667CD87, 
$61672A47, 
S40072A47, 
$00070987, 
$00078507, 
$00076607, 
$00073407, 
$00O7E8C7, 
S86B7D577, 
$66878667, 
$68636063, 
$86818861, 



SFFFDFFFD, 
SFFFBFFFB, 
$00070607, 
$00076667, 
$03078887, 
SO7E701E7, 
SOFE707E7, 
S1FC70FC7, 
$3F071Fe7, 
S7C073C07, 
SF8677867, 
SC867C667, 
506678667, 
$88078687, 
$88676067, 
$60676667, 
$60630863, 
$00018681, 



SFFFDeeee 
SFFFBeeee 

$60070066 
$E0070006 

$FC87eeee 
$FF87eeee 

S9F878000 

$9FC7eeee 
$FFC7eeee 

$FBC76868 

$F9C7eeee 
$E787eeee 

S1F070606 
SFC070000 

$E687eeee 

568876086 
$6883FFF8 

seeeiFFFC 



$FFFDeeee 
SFFFBeeee 

$80070000 
$80678668 

$6ee7Eeee 

S1867F886 
S8687FE88 
SFF87FF88 
$62676260 
$02676206 
$FA87FA86 
S8A07FA00 
$8A07FA0e 
S8A87FA66 
SFE67FE88 
$86676888 
$B8B3FFF8 
SBB81FFFC 



SFFFDeeee 

SFFFB6B8B 
$08676606 
$60676666 
$12678886 
$12070000 
SCD870000 
$22478888 
$22478600 
$01878668 
$66676666 
$66676666 
$66876866 
$66676060 
$66676606 
$86676666 
S8063FFF8 
S6661FFFC 



SFFFDeeee 
$FFFBeeee 

$66876060 
$00070000 
$83078308 
S068787E8 
S08678FE0 
$18871FC6 
$26873F6e 
$46677066 

$8867Feee 

$88870668 
$00070000 
$00070000 
$00870000 
$00070000 
S0883FFF8 

seeeiFFFC 



$68086666, $66606680, $00668686, $60606686 
$60070000, $66688668, SEBBOOOOO, $88800000 
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dc.l seesFeeee, $eeeeaeee, SFceoeeee, soaoeeeeo 

DC .l seeFFeeee, sBaeeaeee, SFFeeeeee, seeeeeeee 

DC.L $eiFF8888, $68668686, SFF886808, $88888886 

DC.L $83FF8888 ( $88888688, 5FFC88888, $88888688 

DC.L $63FF8888, $86686668, SFFCeeeee, $88888886 

DC . L $87FF888e, $68866888, $FFE6ee86, $88888888 

DC.L $67FF6868, $86866886, $FFE66888, $86888888 

DC.L $67FF8886, $88868868, $FFE6888e, $88888688 

DC . L $87FF8888, $88888888, $FFE888e8, $86868888 

DC . L $83FF668e, $88888888, $FFE88888, $88888888 

DC.L $83FF8888, $88888888, $FFC88888, $88888888 

dc.l seiFFeeee, seeeeeeee, $FF8eeeee, seeeeeeee 

DC . L $88FF8888, $88888888, $FF888888, $88888888 

dc.l $ee3Feeee, seeeeeeee, $Fceeeeee, seeeeeeee 

DC.L $88878888, $80000088, $EB888888, $00888000 

dc.l seeeeeoee, seeeeeeee, seeeeeeee, seeeeeeee 

* 2 by 18 words 
s26 

DC . L SFFFF66BB, SFFFFFFFF, SFFFFBOOO, SFFFFFFFF 

DC.L $80800000, $80008000, $00010000, $00010001 

DC.L S9C711C71, SA082BCF3, $C71DC71C, S8821CF3D 

DC . L S9C711C71, SA882BCF3, SC71DC71C, S8821CF3D 

DC.L S9C711C71, $A882BCF3, SC71DC71C, S8821CF3D 

DC.L $88800000, SBCF3BCF3, $00818000, SCF3DCF3D 

DC.L $88866888, $88008800, $88818888, $88010001 

DC.L $9C711C71, SA682BCF3, SC71DC71C, S8821CF3D 

DC . L S9C711C71, SA082BCF3, $C71DC71C, $8821CF3D 

DC.L S9C711C71, SA882BCF3, SC71DC71C, S8821CF3D 

DC . L S88888888, SBCF3BCF3, $00010000, SCF3DCF3D 

DC.L $88800006, $80008800, $06010000, $00010881 

DC . L S9C711C71, SA082BCF3, SC71DC71C, S6821CF3D 

DC.L $9C711C71, SA682BCF3, SC71DC71C, S8821CF3D 

DC.L S9C711C71, SA882BCF3, SC71DC71C, S8821CF3D 

DC . L $86660066, SBCF3BCF3, $80610686, SCF3DCF3D 

DC.L $80686660, $80008000, $66616608, $88818861 

DC . L SFFFF8888, SFFFFFFFF, SFFFF8888, SFFFFFFFF 

* 2 by 18 words 
s27 

DC . L SFFFF8888, SFFFFFFFF, SFFFF8666, SFFFFFFFF 

DC.L $86888888, $86688866, $66818886, $88818861 

DC.L $88886688, $86888866, $66616606, $00018801 

DC . L $88888888, $88000000, $06010000, $00010001 

DC.L $88008606, $88688666, $68618888, $86818881 

DC . L $88888888, $88008888, $88016060, $00010001 

DC . L $88888888, $88008880, $00010000, $00010001 

DC.L $86688888, $88888668, $88816868, $86616881 

DC . L $88888866, $88888686, $88818866, $68818881 

DC . L $88888866, $88688868, $86816668, $86618881 

DC . L $88688688, $88888886, $88618886, $88818881 

DC.L $88886888, $88888860, $88818888, $88816881 

DC.L $88886868, $88888888, $86818888, $88816881 

DC . L $88888888, $88888688, $86818886, $88818881 

DC . L $88688888, $88688868, $88818868, $86818881 

DC . L $88888888, $88688888, $88818868, $86818881 

DC . L $88886888, $88688888, $88818886, $88818881 

DC.L SFFFF8888, SFFFFFFFF, SFFFF8888, SFFFFFFFF 
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As a heavy PC user I am familiar with 
the major word processors for the 
MS-DOS computers such as Wordstar (my 
favorite by habit), Microsoft Word, WordPer- 
fect and others. These programs typically 
cost hundreds of dollars, have documen- 
tation that could strain a pack mule and 
offer complete word-processing power 
that is primarily meant for office use Not 
since Final Word by Mark of the Unicorn 
have I seen a seemingly "professional" 
word processor for the ST. As you may al- 
ready know, Final Word, which debuted 
soon after the release of the ST, was less 
than spectacular. It was clumsy to use, er- 
ror prone, had copy protection and 
couldn't produce the normal everyday 
types of hard copy that people need to do. 

For the past year or so there have been 
three ST word processors that perform 
about equally and seem to be the most 
popular with knowledgeable users. They 
are Regent Word II by Regent Software, 
Word Writer ST by Timeworks and 1st 
Word, the freebie that came with almost 
everybody's ST. Despite the selection of 
three (and possibly more) good word 
processors there still has not appeared on 
the market what I call a "Macintosh-class" 
word processor for the ST. By that I mean 
a word processor with multiple fonts 
(more than just bold, italic and su- 
per/subscript), on-screen formatting, 
professional quality features such as foot- 
noting, endnoting, top-notch spelling 
checking and more. The ST computer is 
a mature, three-year-old product. So 
where is the mature word processor for 
the machine? 

The most recent entrant in the ST word 
processing sweepstakes is WordPerfect 
4.1 for the ST. It originally debuted in the 
late fall of 1987 but the company itself ad- 
mits the first release was somewhat bug- 
gy. Since then WordPerfect has cleaned 
up the bugs in the program and provid- 



by Arthur Leyenberger 



ed several updated releases to registered 
users. The version of WordPerfect that 
you buy today is virtually bug-free. 
However, the question still remains — is 
WordPerfect ST the ultimate word proces- 
sor for the ST? 

I don't have room in this space for a 
complete review of WordPerfect. 
Moreover, I cannot do a thorough com- 
parison of all of the ST word processors. 
What I can do is give an overview of the 
program as I am actually using it now to 
write this month's column. 

A First Look 

What is WordPerfect? In summary, it is 
a very complete word processor. The ST 
version which I am discussing, is file- 
compatible with WordPerfect 4.1 for the 
IBM PC and other computers, allowing 
for direct document transfer to and from 
the ST without losing document format. 
The program offers a plethora of features 
such as footnotes, endnotes, macros, spell- 
ing checker, thesaurus, sorting, paragraph 
outlining/numbering, a math mode for 
columnar numeric tables, indexing and 
table of contents generation. It uses a full 
GEM interface complete with drop down 
menus, multiple windows, mouse or key- 
board control and access to any current- 
ly active Desktop Accessories. 

The WordPerfect package comes with 
six disks, a 600-page manual housed in a 
slip case, a multi-colored keyboard tem- 
plate (containing WordPerfect's menu) 
that is placed above the ST's function keys, 
a quick reference card and a toll-free 
number for support (available once the 
registration card is returned). The whole 
kit and caboodle costs $395 list, which 
seems steep compared to other "serious" 
software for the ST. Although the pack- 
age appears professional and complete, 
one might legitimately ask if the program 
is worth almost as much as the price of 
a monochrome ST system? 

I'll attempt to answer that by means of 
a guided tour of the program and its fea- 
tures. Starting with installation, setup and 
on to printing, we'll have a look together, 
at what might or might not be the best 
word processor for the ST currently 
available. 



Arthur Leyenberger is a human factors psy- 
chologist and freelance writer living in New 
Jersey. He has written over 100 articles about 
computers in the last four years and continues 
to be an Atari enthusiast. When not comput- 
ing he enjoys playing with robotic toys. 



The Tour 

Well, it only took me about an hour to 
get WordPerfect installed to the point 
where I could actually print the first few 
paragraphs above. Like most computer 
users, I was eager to get the program go- 
ing and see some output. I read and re- 
read the documentation, used what I con- 
sider to be common sense in these mat- 
ters and it still wasn't as easy as it should 
have been. I don't think I like what I've 
seen so far, but I am willing to hold off 
final judgment of the program until I put 
it through its paces. 

First, I need to tell you the configura- 
tion of my system so that you can follow 
along and, if you have the same setup, 
learn from my experiences. I have a 
520ST with one megabyte of memory, a 
Supra 20 megabyte hard disk, one double- 
sided disk drive and an Epson FX-80 
printer. I have been using a monochrome 
monitor but will also try the color moni- 
tor as well. I also have a 5'/i inch, IBM- 
type disk drive as drive B, but 1 decided 
to disconnect it from the system for pur- 
poses of this evaluation. Things often get 
confusing enough when you are using a 
program for the first time, and I wanted 
to keep the system as "stock" as possible 
so as to prevent any additional problems. 

The instructions told me to create a 
separate folder on my hard disk and then 
to copy the program, spelling, thesaurus 
and learn files (each on their own disk) 
to that folder. I attempted to install my 
printer and ran into several problems. 
There are two additional disks, labeled 
Print and Font, and the instructions said 
to insert the Print disk into drive A when 
prompted to insert disk in drive B. This 
repeatedly did not work, and it was only 
until I copied the entire contents of the 
Print disk to the "WP" folder on the hard 
disk that I was able to proceed beyond 
that point in the installation process. I no- 
ticed that during the printer setup, there 
was one extra step on the screen that the 
manual did not mention. You can install 
up to six printer definitions, which I guess 
might be useful to some people, but I 
think the screen prompt was asking if I 
wanted to save all printer definitions, 
rather than just the one I chose, to the 
hard disk. 
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There was nothing in the instructions 
concerning the Font disk, and I was una- 
ble to print anything at first. In fact, ev- 
ery time I tried to print, the program told 
me it couldn't find the printer file and 
bombed. After rebooting and going 
through these shenanigans a couple of 
times I copied the entire contents of the 
Font disk to the hard disk folder and went 
back to re-install. During the course of in- 
stalling the printer, I noticed errors in the 
manual. For example, Page 548 says "select 
printer controls (4)" meaning press the 
number "4" on the keyboard or mouse 
click on the fourth option in the menu list. 

As it turns out, there were only three 
options presented, and pressing "4" had 
no effect. This error, the extra step men- 
tioned above and the confusing/incorrect 
procedure for reading the files from the 
Print and Font disks suggest that the pro- 
gram changed after the documentation 
was written. I can understand this, but the 
normal practice, especially for programs 
costing this much and purporting to be 
"professional," is to include an errata 
sheet listing the errors or additional steps 
missing from the documentation. There 
was no errata sheet included with the 
WordPerfect package. 

Dislikes 

Let me mention some other things I 
disliked about the program. When you 
want to search for a particular text string 
you must enter the string and then use 
the mouse to click on OK. There is no 
default button that normally is selected 
when pressing the return key, as with 
many GEM applications. In fact, hitting 
RETURN causes the ASCII code for the 
return key to be entered as the search 
string. The only time using the mouse to 
click on OK is not awkward is when you 
do a subsequent search. Then, you can 
use the mouse to click on the Search 
menu, choose forward or reverse and 
then, since the previous string is dis- 
played, just click on OK. 

When you use the copy/paste function 
and the program accesses the file, there 
is no "busy bee" icon to let you know the 
machine is busy. The keyboard is locked 
out, although there is no indication of it. 
Whenever the program has to access the 
disk drive (hard disk in my system), access 
time is extremely slow. This may be as 
much the fault of the ST as with the pro- 
gram. Also, retrieving a file is not as 
straightforward as it could be since you 
must first choose "List Files," click on the 
filename and then click on "Retrieve." The 



file selection procedure done with the 
familiar GEM file list box seems easier. 

Here are a couple of snipits. The tem- 
plate that comes with the package is a 
good idea, but its execution could be bet- 
ter. The plasticized cardboard slips in be- 
hind the function keys and there is a 
small piece that extends to the left which 
labels the alternate, control and shift key's 
functions on the template. Since the left 
side of the template extends beyond the 
slot, it holds the template in place so that 
the four rows of functions can be easily 
read. However, the right side of the tem- 
plate does not extend past the slot, so the 
template falls down into the slot, making 
the bottom two rows of the labels on the 
three right-most function keys difficult to 
read. 

Another minor problem has to do with 
the design of the documentation binder. 
There are no pouches on the inside 
covers of the binder to hold the quick 
reference guide and other materials. Fur- 
ther, there are no disk holder pages to 
house the six floppies that come with the 
program. Granted, these are minor 
points, but in an otherwise professional- 
ly looking package they stand out as be- 
ing incomplete. 

Likes 

Although I have some minor com- 
plaints about the program, I don't want 
to give the impression that I hated the 
program, because that's not true. There 
is no question that the program is feature- 
laden, and generally the multitude of fea- 
tures do not get in the way of the primary 
purpose of the program. Here are some 
of the things I did like during my 20 or 
so hours of concentrated use. The auto- 
matic backup is a useful feature, especial- 
ly since you can set the frequency at 
which the backups will occur. I started out 
with a five-minute backup interval, but it 
was just too often and soon became an- 
noying. I then tried ten minutes and even- 
tually settled on 15 minutes. When the 
automatic backup occurs, a small window 
appears announcing "backup in 
progress." You do not lose any keystrokes, 
although when the window appears the 
cursor freezes where it currently is. 

One feature I liked was the Date func- 
tion. From the Format menu, selecting 
date will put the current system date 
wherever the cursor happens to be. Once 
the date is inserted into the text, it be- 
comes text and will not change. Another 
feature I liked was the Menu Bar Lock. 
When this function is enabled it prevents 



the menus from automatically dropping 
down from the Menu Bar when the cur- 
sor touches one. Instead, the right mouse 
button is used to enable the drop down 
menu and the cursor arrow does not have 
to be near the menu name. Wherever the 
arrow is horizontally across the screen, will 
cause the menu directly above it to drop 
down when the right button is pressed. 

Still another feature I liked was the List 
Files function. When requested, List Files 
will display files in the current or another 
folder and allow you to retrieve, delete, re- 
name, print or copy files. In addition to 
acting on individual files, you can tag 
them for mass execution, such as when 
you want to delete a group of files or copy 
several at a time. Other functions in List 
Files include searching one or more files 
for specific words or phrases and display- 
ing the contents of a file on the screen. 
Having these file management com- 
mands available from within a word 
processor program is quite handy. 

WordPerfect has many other features to 
like as well. Earlier, I mentioned that the 
ST user is still awaiting a Macintosh-like 
word processor and wondered if Word- 
Perfect was the product we have all been 
waiting for. I'm sorry to say it is not. 
Although it is a what-you-see-is-what-you- 
get type of word processor, it does not 
have multiple on-screen fonts in varying 
sizes, is not as "classy" as MacWrite and 
contains too many unpolished aspects to 
be in that class. On the other hand, in 
terms of features, a street price of about 
$250 and WordPerfect's support of Atari 
users, there is no other ST word proces- 
sor that can match it. 

The End 

Sometimes a review reveals as much 
about the company that created the 
product as it does about the particular 
hardware or software under review. This 
has certainly been true with WordPerfect 
Corp. Their toll-free telephone support 
lines, free revisions of the program to 
registered owners and general attitude 
show that they are a first-rate company 
that does business the way it ought to be 
done. If you need the best currently avail- 
able word processor for your ST, the only 
choice is WordPerfect. 

WordPerfect 
WordPerfect Corp. 
288 West Center Street 
Orem, Utah 84057 
(801) 225-5000 
$395.00 
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Creative Computer Design/ 
Dirk Beyelstein 
Eltville, West Germany 
Color or Monochrome. 
Distributed in the USA by: 
Eidersoft USA 
P.O. Box 288 
Burgettstown, PA 15021 
(800) 648-9191 
$42.99 



Reviewed by Charles F. Johnson 



There's a good deal of ground- 
breaking new ST software being 
written in Europe — West Germany, En- 
gland and Hungary, just to name a few 
countries. This makes perfect sense when 
you consider that the ST was officially 
released in Europe before the USA, and 
that European programmers had already 
gotten a head start programming the 
68000 chip contained in the ST when Sin- 
clair released its ill-fated, 68000-based QL 
computer several years ago. The QL 
vanished into the mists of computer his- 
tory, but the ST has been a success story 
since it's release, especially in Europe and 
the UK. Some of these innovative Euro- 
pean programs are beginning to appear 
in the USA at last, and Eidersoft is respon- 
sible for marketing many of them. 

One of these is Tempus, a product of 
Creative Computer Design in Eltville, 
West Germany. First things first — what 
Tempus isn't: It isn't a word processor. It 
lacks some of the necessary functions to 
be a full-fledged word processor, such as 
"word-wrap." Each line must be entered 
separately, and ended with a RETURN, 
just as if you were using a typewriter. With 
most word processors, you just keep typ- 
ing without hitting RETURN; the pro- 
gram takes care of keeping your text 
nicely formatted, on the screen and on 
the printer. Also, Tempus' printer output 
is rudimentary at best; although you can 



create a printer configuration file, there 
just aren't as many options as a true word 
processor would normally allow. For ex- 
ample, there is no explicit support for 
boldface type, italics or different charac- 
ter sizes, although you can imbed printer 



control codes in your text to achieve these 
effects. 

Now that we know what it isn't, here's 
what Tempus is— fasti The program em- 
ploys a full GEM interface, the equal of 
1st Word's (actually, better), but this baby 
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really flies] Quite simply, Tempus is the 
fastest text editor I've ever seen, far faster 
than any current ST text editor or word 
processor. It's text output keeps up with 
the most talented touch-typist with ease. 
Scrolling through a document is so quick, 
either with the mouse or with the func- 
tion keys, that you have to watch very care- 
fully or you'll overshoot. But Tempus is 
not only fast at displaying the text on- 
screen — it also is amazingly speedy at 
loading files, and at searching for words 
or strings of text. 

Tempus is designed primarily for use 
by programmers (in any language), and 
has many features specifically aimed at 
making editing source code easier. It is 
fully compatible with the Megamax C and 
Personal Pascal development shells, and 
should work with most other shells and 
CLI interfaces that allow the running of 
GEM programs. According to the manu- 
al, CCD spent over a year developing the 
program, which is written entirely in as- 
sembly language for maximum perfor- 
mance and compactness. 

Tempus has lots of other nice features 
besides its speed, too. You can load up to 
four documents at once, each in its own 
GEM (actually, pseudo-GEM) window, and 
move the windows, resize them or close 
them. The program can load fonts creat- 
ed with the DEGAS font editor for screen 
display (not for the printer, unfortunate- 
ly). You can set up to five "marks" in a 
document and instantly jump to any of 
them with a mouse click. You can define 
up to 20 function key macros, for com- 
monly typed words and strings of text, 
and save them to disk so they'll load au- 
tomatically when you run Tempus. Tab 
spacing can be adjusted to suit your 
preferences. Any ST character (from AS- 
CII 0 to 255) can be entered into a docu- 
ment. In high-resolution monochrome, 
each window can display either normal- 
sized text, or half-height text to see twice 
as many' lines in the window. 

Tempus has a comprehensive set of 
block functions that can be accessed with 
either keyboard or mouse, like block 
move, delete and copy. Blocks of text can 
also be saved to disk and merged into 
other documents, or sent to the printer. 
There is a help menu available, in case 
you're confused about something. And in 
several weeks of working with the pro- 
gram, I haven't managed to make it crash 
once (something I wish I could say about 
certain other ST programs which shall re- 
main nameless). 

Tempus even includes a Reverse Polish 
Notation calculator, which for some inex- 
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Tempus uses the GEM metaphor to 



plicable reason is called a "UPN Calcula- 
tor" in the program, even though the 
manual has the initials correct. The cal- 
culator can be very helpful, precisely at 
the time when you need it most. . .dur- 
ing text editing. However, the Tempus cal- 
culator is not the best one I've seen for 
the ST; the screen display bears no resem- 
blance to the arrangement of the keys on 
the ST's numeric keypad. Also, the RPN 
method may be confusing to people who 
are accustomed to the traditional pocket 
calculator. Fortunately, you can easily in- 
stall one of the many commercial or 
public-domain desk-accessory calculators 
if you wish; desk accessories are fully sup- 
ported by Tempus. 

When loading or saving documents, 
Tempus uses a customized file selector, 
not the normal GEM item selector that 
we've all come to know and love/hate. The 
Tempus file selector has every feature of 
its GEM counterpart, along with some ex- 
tra capabilities that make it much easier 
to use. Drives are selected by clicking on 
a button, instead of by editing the direc- 
tory line. Much more information is avail- 
able about the files displayed; you can 
show the size and time/date stamp of each 
file as well as its name. A list of standard 



filename extensions is provided as well, 
such as .BAS, .S, .ASM, C, .PAS, etc. 

Tempus doesn't use real GEM windows, 
either, although they look and behave 
almost exactly alike. As with the file selec- 
tor, Tempus windows are fully compatible 
with GEM windows. . . but with some im- 
provements. The slider bars and scroll ar- 
rows are auto-repeating; in other words, 
you may click and hold the mouse but- 
ton on them to scroll horizontally or ver- 
tically through the text without repeated 
button presses. The top line of each win- 
dow displays the name of its associated 
document, just as in 1st Word or any 
other GEM editor, but it also can display 
information about the current cursor lo- 
cation. And of course, everything about 
the Tempus windows works at an order 
of magnitude faster than standard GEM 
windows. In fact, when you exit Tempus 
back to the GEM desktop, the feeling is 
somewhat akin to stepping off a fast es- 
calator. It will give you an appreciation 
for how slow GEM really is, and how quick 
it could be. 

The search routines are very flexible, al- 
lowing backward or forward searches with 
the option to ignore upper/lowercase 
differences. Up to 20 strings may be en- 
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its fullest, without sacrificing speed. 



tered and remembered by the program 
for subsequent searches. Searches can be 
limited to a specified region or include 
the whole text. Search strings can include 
wildcards that stand for any character. 
And did I mention that the search rou- 
tines are fast? The only deficiency in Tern- 
pus' search capabilities is that it can't 
search for a string of text that extends 
across more than one line. 

One of Tempus' nicest features is the 
ability to create a cross-reference list from 
a group of strings. The strings are entered 
into the Search dialog box, with up to 20 
allowed. When you choose Cross Refer- 
ence List from the drop-down menu, Tem- 
pus will generate a file which includes the 
line numbers where each string appears 
in your document, a very handy tool for 
programmers. But Tempus takes this con- 
cept a step farther. The cross-reference list 
can be loaded into its own window. Then, 
if you make the document window active 
and the cross-reference window inactive, 
you can click with the right mouse but- 
ton on the line numbers in the list, and 
the cursor in the document window will 
instantly jump to that line, ready to start 
making changes! This is an extremely 
well-thought-out feature, and can be espe- 



cially useful to programmers at those 
times when their compiler/assembler spits 
out a list of errors categorized by line 
number. 

All Tempus commands can be entered 
either with the mouse or the keyboard. A 
slight drawback is that the key combina- 
tions used for the commands are rather 
cryptic and arbitrary. For example, CTRL- 
C to page down, CTRL-L to search, or 
CTRL-Y to delete a line. This is a minor 
point; it's just a matter of learning and 
becoming accustomed to the keys used. 
(Although if you've used EMACS, there's 
a potential "gotcha" lurking here. In 
EMACS, CTRL-Y is used to restore a delet- 
ed line!) Unfortunately, function key mac- 
ros can only contain strings of text, not 
commands, and so this reduces their use- 
fulness as a substitute for Tempus key 
commands. 

The 83-page Tempus manual is trans- 
lated from German, and rather poorly; 
mangled grammar abounds. However, the 
manual is professionally laid out, and it's 
reasonably complete except for the lack 
of an index. All the details of Tempus' 
operation are covered adequately, with il- 
lustrations to help explain the main 
screens and dialog boxes. The manual 



comes packaged in a small gray, two-ring 
binder. 

Tempus is not copy-protected, and it 
may be freely copied to any disk, even a 
hard disk or RAM disk. Instead of physi- 
cal copy-protection, Tempus makes you go 
through an installation process before 
you can use the program, by running the 
included INSTALL.PRG. This program 
asks you to input your name and address, 
and then (I presume) writes this info 
along with your disk's serial number into 
TEMPUS.PRG. After this is done, IN- 
STALL.PRG wipes itself from the Tempus 
master disk. Although this "registration" 
method has obvious advantages for the 
user (no need to constantly keep swap- 
ping a key disk), I had a serious problem 
when I ran INSTALL.PRG. 

I followed the instructions for running 
INSTALL.PRG scrupulously, finished en- 
tering my name and address, and clicked 
on the box labelled "Input Done." The 
disk spun for a moment, then I exited 
back to the desktop. Everything seemed 
fine. . .INSTALL.PRG was gone from the 
disk, but the manual said that would hap- 
pen. I ran Tempus and loaded a text file, 
made some changes to it (thinking, Wow, 
this thing is fasty, and then tried to save the 
edited file. Lo and behold, a dialog box 
popped up with the message, "Un- 
installed demo version." Something had 
gone wrong in the installation process, 
and I ended up with a copy of Tempus 
that was unable to save or print files. In 
short, a useless copy of Tempus. And since 
INSTALL.PRG had deleted itself from the 
master disk, there was no way to try again! 
To make matters even worse, after at- 
tempting to save my text file with this 
"demo version," Tempus destroyed my 
original file, leaving me with a file of zero 
length. Luckily, I had a backup of my file; 
otherwise I might have been very peeved. 
At that point, there was no recourse ex- 
cept to send the disk back to Eidersoft 
and get a new copy, which worked fine. I 
have no idea what went wrong with my 
first attempt at installation, but you'd be 
well-advised to be cautious the first time 
you use Tempus. 

To sum up, Tempus is an impressive 
achievement — a program which uses the 
GEM metaphor to its fullest, without 
sacrificing speed. Even running on a 
Mega ST4 with blitter chip enabled, no 
other text editor comes close to the per- 
formance of Tempus. And here's some- 
thing to look forward to: The manual 
states that a full-featured word processor 
based on Tempus is currently in the 
works. I, for one, can't wait! 
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Advanced 

OCP 

Art Studio 

Rainbird Software 
Published in the USA by Firebird 
P.O. Box 49, Ramsey, NJ 07446 
Low resolution only 
$39.95 

Reviewed by Maurice Molyneaux 



ST "paint" programs are not an en- 
dangered species; one might be 
tempted to say we have an overabundance 
of them. There's NEOChrome, DEGAS, 
DEGAS Elite, PaintWorks, Art Director, 
Spectrum 512 and the upcoming (may be 
out by now) Quantum Paintbox, etc. In 
the midst of all this, Rainbird — a compa- 
ny well-known to ST users for its excellent 
games — drops into the market with its 
own paint software: The Advanced OCP Art 
Studio (OCP stands for "Oxford Com- 
puter Publishing," the concept on which 
Art Studio is based). 

At first glance the program is impres- 
sive A lot of attention was lavished on the 
look of the user interface. The icons on 
the "control screen" are nicely shaded and 
drawn. When you point at an icon, in- 
structions appear in the VIEW WINDOW 
(which otherwise shows a real-size image 
of the object currently on the editing 
"grid"), making each icon's function eas- 
ier to decipher. When you run the pro- 
gram, you are asked if you have the En- 
glish or German manual. Further, once 
inside the program you can (at least horn 
the English mode) toggle the icon descrip- 
tions to be displayed in French! The pro- 
gram works in low resolution only, allow 
ing you 16 colors for youi graphics. You 
can have two workscreens on a 520ST, and 
up to ten on a 1-meg machine (no idea 
of the limit on a Mega!). 



The program treats special graphics 
blocks as "brushes" and "sprites," which 
can be created on the control screen's 
grid, or can be "cut" from one of the work 
pages. Furthermore, these brushes can be 
placed in a large "store," which itself can 
be saved and loaded. The store permits 
instant access to numerous graphic ele- 
ments, sparing you from having to cut 
and paste chunks from one screen to 
another. The items in store can be rear- 
ranged, and the whole store can be 
viewed to see its contents. 

"Fonts" are merely brushes, using as 
many colors as you like, which are placed 
in the brush store, and then "typed" on 
the screen. However, the text does not be- 
come your paintbrush, as it does in Art 
Director. 

Portions of the screen or grid can be 
flipped horizontally or vertically, or 
turned to the right, 90 degrees at a time. 
A window mode allows a rectangular area 
of the screen to be cleared, cut and past- 
ed, edited in grid mode, rescaled or 
smoothed (anti-alias). The smooth option 
is quite nice, though it works well only if 
you have selected a number of mutually 
complementary colors. 

Many operations can be carried out 
with only the currently selected "ink" 
color, or using all colors. The screen's 
border color isn't transparent as in most 
paint programs, but opaque. Transparent 



areas can be defined only on brushes and 
only from the grid. Additional options 
make it possible to replace all pixels of 
a given color with another color, or even 
to have the program auto-outline images 
on the grid. Pixel-by-pixel fine-tuning is 
possible, but the magnify mode is a little 
unusual. The magnified area (64 x 64 pix- 
els) is cut to the grid, edited and must be 
copied back to the workscreen by clicking 
on magnify again, or the changes aren't 
incorporated. 

The program features a special map 
mode for designing games. Maps are 
made up of brush "blocks." Brushes are 
assigned ASCII characters, and the map 
proper consists of an ASCII table with 
characters defining which block goes 
where. A final map file is output as a .S 
file, which can be merged into a pro- 
gram's source code. The brushes are out- 
put as bit images. 

Simple animation is supported by Art 
Studio. It saves and loads pictures in 
NEO-Chrome format, thus supporting 
NEO's color-cycling animation. Sprites 
can be designed and test-animated from 
within the program as well. Sprite images 
are placed in the brush store, in proper 
order, and can be viewed in movement on 
the control screen or in front of a work- 
screen (at an adjustable speed). Defining 
such a loop is easy, but the sprites must 
be in order, first to last. The sprite ani- 
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mation is not saved as part of the picture 
file. But, like the map mode's brushes, 
sprite data can be saved for inclusion in 
programs. 

Art Studio does have its weaknesses. 
Brushes can only be 8x8, 16x16, 16x32, 
32x16, 32x32, 32x64, 64x32 or 64x64 pix- 
els, with no intermediate or greater sizes 
allowed. The "spray" painting tool is not 
adjustable, and there seem to be no 
modes for drawing ellipses, rays or con- 
tinuous lines. The copy (cut and move) 
option only duplicates a block. You can- 
not use a cut block as a brush (though you 
can stamp it multiple times). 

While the program is strongly mouse- 
dependent, it does not use the mouse for 
file selection. You have to type in path- 
and filenames. To worsen matters, the pro- 
gram will not recognize a drive beyond 
unit D. I could not get it to access parti- 
tions E and F of my hard disk. 

Art Studio has separate undo options 
for both the screen and the grid, but the 
ST's undo key is not supported. To undo 
a mistake on a workscreen, you must 
return to the control screen to access the 
undo icon. 

Finally, there is no provision for setting 
up printer drivers. The manual instructs 
you to use the Control Panel/Set Printer 
accessory. Unfortunately, that accessory 
doesn't let you set up a printer driver, and 
the program makes no provision to let 
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you access the accessory or any such con- 
trols from within itself. If you need to 
alter the printer settings, you'll have to 
quit the program, make adjustments, then 
run Art Studio again. 

The program supports Eidersoft's Pro- 
Draw graphics tablet, and comes with a 
demo which shows how the program is 
used. Files containing a font brush and 
regular brush stores are included. The 
single-sided disk is not copy protected, 
but the program refers the user to its 
manual, asking you to type in a key word, 
in order to assure that you have a legiti- 
mate copy. The manual is good overall, 
but some descriptions are not very clear. 
It sometimes takes several tries to figure 
out just what you're supposed to do. 

To sum up: With its map and sprite- 
designing features, The Advanced OCP 
Art Studio looks useful for game design- 
ers and programmers. However, with its 
weaknesses in many purely artistic 
regards, and not terribly intuitive user in- 
terface, I cannot recommend it to most 
users. If you desire to paint, you would be 
better off with the multitude of easy-to- 
use tools in Art Director or DEGAS Elite 
or with the color possibilities of Spectrum 
512. 

The author would like to thank Larry Elliott 
at Computer House in Sparks, Nevada, for 
providing the software for this review. 
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Reviewed by David Duberman 



The Atari ST is by far the best hard- 
ware value in MIDI computing, 
thanks to its low price and built-in MIDI 
ports and programmability. Nonetheless, 
most of the interesting (i.e., experimental) 
MIDI software are available only for Ap- 
ple's Macintosh, simply because it's been 
around longer. Thus it's extremely en- 
couraging to note that one of the fore- 
most publishers of Macintosh MIDI 
software, Digidesign of Menlo Park, 
California, has released its $295 Softsynth 
program for the Atari ST. 

The name Softsynth is an abbreviation 
of the term Software Synthesizer. The pro- 
gram uses your ST's computing power to 
create complex new sounds to be played 
back on a sampler. Supported samplers 
are: E mu Emax and Emulator; Ensoniq 
Mirage; Korg DSS-1; Sequential Prophet 
2000; Roland S-10 and S-50; and Akai 
S900, X7000, X700 and S612. In case 
you're not familiar with the terminology, 
a sampler is a kind of synthesizer that can 
record and play back real sounds, rather 
than create them entirely from scratch as 
conventional synthesizers do. Samplers 
use digitized sound, just like CDs. And 
since a sampled sound is just a (long) 
string of numbers, there's no reason why 
its source can't be a computer instead of 



a microphone. 

Softsynth uses the ST to perform two 
different kinds of synthesis — additive and 
FM — separately or in combination. Addi- 
tive synthesis is not a simple topic, but 
Softsynth's manual provides a clear, 
thorough discussion of it. As a brief ex- 
planation to help you understand this 
review, every sound you hear can be 
broken down into several combined 
sound waves (much as a ray of light can 
be divided into a spectrum with a prism); 
a fundamental wave and any number of 
harmonic waves or partials, whose fre- 
quencies are multiples of the fundamen- 
tal's. Additive synthesis uses multiple 
independent sine waves to "build" new 
sounds or recreate existing ones. Each 
sine wave in an additive sound has its own 
envelopes for frequency and amplitude. 
This means that during the time that you 
hear a sound, the loudness and/or pitch 
of each of the sound's elements vary in 
more-or-less subtle ways to produce what 
musicians called timbre events, or 
changes in the nature of the sound over 
time. Given sufficient control, additive 
synthesis gives you the power to recreate 
synthetically any sound in existence — or 
out of existence. 

Softsynth's version of additive synthe- 



sis gives you up to 32 independent sound 
waves or oscillators. It's a fully GEM-based 
application that works in medium- 
resolution color or high-resolution 
monochrome. Although drop-down men- 
us are available, the most commonly used 
commands are always accessible via on- 
screen icons and the keyboard, making 
the program quite easy to learn and use. 

Softsynth's main screen shows an over- 
all 3-D view in three-quarters perspective 
of the amplitude envelopes of the 32 
sound waves, which you can rotate to four 
different angles. From here you set the 
fundamental frequency, the sample rate 
and the fde length. Menu commands let 
you set your sampler, save and load 
parameter files, and save the program's 
current configuration. Arrayed across the 
bottom of the screen are 32 mouse- 
controlled sliders for setting each har- 
monic's overall loudness. When you click 
on any slider, its current numeric value 
is shown. 

When you click on a harmonic's iden- 
tifying number below a slider the main 
screen is temporarily replaced by the har- 
monic's edit screen. This shows the enve- 
lopes for amplitude and pitch, both of 
which you manipulate directly with the 
mouse and tools represented by icons. 
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You can preview the partial's sound at any 
time. From here you can select directly 
any other partial to edit, but you must 
return to the main screen to hear the full 
sound. 

Softsynth lets you set as many as 40 (!!) 
stages in each partial's amplitude enve- 
lope and up to 15 in the frequency enve- 
lope. You can also set the partial's ratio 
to the fundamental pitch, after which 
Softsynth calculates the actual frequency 
for that partial. Finally, you can set a wave- 
form type for the partial, selecting from 
Sine, Square, Triangle, Bandlimited Noise 
and White Noise. This ability to use wave- 
forms other than the usual sine wave 
makes it easier to create interesting 
sounds more quickly, as well as to add spe- 
cial effects. 

Softsynth also offers an alternative 
method of additive synthesis which gives 
you more control over the overall sound 
while sacrificing fine control. Time Slice 
Editing lets you control relative levels of 
the individual partials by means of timbre 
events, which are "snapshots" of the am- 
plitude of each partial at a given moment 
in time. A single, overall amplitude enve- 
lope is shown, with any number of timbre 
events arrayed underneath. Click on a 
timbre event and the current levels of all 
partials at that point are shown on the 
slider display, ready for you to adjust if 
you like. You can add, delete and move 
timbre events. The manual provides a 
tutorial in use of the unusual Time Slice 
method. 

The concept of FM synthesis in a nut- 
shell involves different sound waves inter- 
acting as carriers (audible) and modula- 
tors (usually inaudible, modulating 
carriers). Softsynth's advanced FM im- 
plementation lets you set any partial to 
modulate any other partial (including it- 
self), with modulators audible or not. 
You'll be surprised at the complexity of 
the sounds you can create with relatively 
few operators. That's the power of FM syn- 
thesis, while the drawback is loss of fine 
control over subtler aspects of the sound. 

Finally, Softsynth's Smartsynth function 
is a wonderful way to experiment with 
sound. To quote the manual, "Smartsynth 
uses parameter ranges and a random 
number generator to create new 
sounds" — that is, it's an "auto-droid" func- 
tion. You can set just about any combina- 
tion of a screen full of parameters such 
as Harmonic Series, Range and Filter, Par- 
tial Detuning, Doubling, Frequency Move- 
ment and Attack, and Attack and Decay 
Rates. Then Softsynth throws a few dice 
and creates for your ears only a brand- 



new never-before-heard sound, based on 
your Smartsynth settings and any existing 
sound parameters. You can fine-tune any 
successful results with Softsynth's other 
sections. 

Once you've created a new sound, the 
Preview command lets you hear an ap- 
proximate rendition via your monitor 
speaker or with the ST Sound Digitizers 
(Navarone) or ST Replay (Michtron/ 
Microdeal). Next the Synthesize com- 
mand generates and saves to disk a sam- 
ple file that can then be sent to the 
sampler. If you're using the program to 
experiment with, I recommend use of a 
RAMdisk for this step to save significant 
amounts of time, both in saving the file 
and in sending it to the sampler. 

The process of sending a sample file 
to the sampler varies with different key- 
boards. Fortunately the manual includes 
a separate section with detailed instruc- 
tions for each supported sampler. Soft- 
synth supports each sampler's choice of 
methods of creating multi-samples in 
memory. For example, with the Korg 
DSS-1, you can replace any sample in any 
existing multisound, append a sound to 
a multisound or create a new multisound. 

The program is copy-protected, but 
uses the key disk protection scheme so 
that you can run it from a hard disk, 
RAMdisk or a copy in drive B. But the 
original disk must be in drive A before 
you start — you're not prompted for it. You 
get a free backup when you send in your 
warranty card. 

While Softsynth is near the top of the 
price range for Atari ST software, it's cer- 
tainly one of the finest programs that I've 
used on any computer. It's well-designed, 
easy to use and fast and efficient in oper- 
ation. Samples produced are clean and 
glitch-free. The program's professional 
caliber, combined with the variety of in- 
tegrated ways of creating sounds, offers 
tremendous value even at $295. I recom- 
mend Softsynth to anyone with an ST and 
one of the samplers listed above, and in 
particular to musicians seeking an end- 
less source of new and unusual sounds. 



David Duberman has been involved in Atari com- 
puting for the past five years. He is primarily in- 
terested in the use of personal computers for 
enhancing human creative potential. 
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ALICE 

The Personal Pascal 



An integrated programming environ- 
ment with 700 HELP screens, an editor 
that makes errors impossible, and the 
best GEM interface anywhere. Only 
$79.95. 

"An excellent value." - Antic 

"It is about as painless a method of 
learning Pascal as can be devised 
short of hypnosis. It works!" — 
Computer Shopper 

"The product is all anyone could ask 
for. I would recommend this product 
to anyone who is considering learning 
PASCAL ... or anyone who wishes to 
prototype small applications which 
deaf closely with GEM." - ST Informer 



Orders: 1-800-265-2782 

Looking Glass Software 

124 King St. N. Waterloo, ON. N2J 2X8 519/884-7473 
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STuff 



Michtron 
576 S. Telegraph 
Pontiac, Ml 48053 
(313) 334-5700 

Resolution varies with program used 
$39.95 



Reviewed by Andy Eddy 



Without a doubt, the most difficult 
computer products to review are 
utilities. Generally, all the reviewer can do 
is comment on the adequacy of the user 
interfacing, whether the program works 
or not and to what extent. Graphics usual- 
ly are not too much of a concern, so 
there's even less to discuss. 

Now I've got my work cut out for me 
with a scattering of ST utilities — 21 in 
all — grouped into one single package 
from Michtron called STuff. As you'll see, 
these programs give the user various pow- 
ers not originally programmed into the 
ST; some you'll use, others you may not 
need. All are intended to be helpful to 
different users. 

These utilities are broken down into 
various categories: AUTO folder pro- 
grams, GEM programs, Desk accessories, 
TOS programs and TTP programs. Fol- 
lowing is a list of the programs on the 
disk, with a small capsule review of each 
(if possible or necessary). I'll also mention 
how well the program works and/or its 
limitations. Hey, what else can I say? I told 
you it wouldn't be easy. . . . 

Auto Programs 

AUTODATE— For those without clock 
hardware to automatically plug the time 
and date into the ST, this program lets the 
user input those figures each session, 
whereupon they are saved on the disk. 
When you boot up, AUTODATE requests 
that you update the system time and date 
figures (it uses the last session's statistics 
as a starting point) using the keyboard. 
If you don't start entering those figures 
within a five-second period, the program 



passes up and continues with the boot 
process. 

CAPSLOCK — Eliminating unwanted 
striking of the Caps Lock key, this pro- 
gram requires the Alternate-Caps Lock 
combination to toggle that feature on or 
off. This takes a while to get used to, but 
for sloppy typists like myself (I tend to rest 
the balls of my palms against the lower 
rail of the keyboard and frequently bump 
into the Caps Lock inadvertently), it can 
protect you from wasted time. 

HARDAUTO— Not owning a hard disk 
at the time of this writing, I was unable 
to test this program. It claims to allow a 
user the power to boot the system up off 
of the hard-drive's AUTO folder. If there 
are any remaining .PRG files in the A: 
drive's AUTO folder, they will execute fol- 
lowing the hard-drive boot. 

HIGH— Placing this in an AUTO folder 
bumps the ST into medium resolution 
from its default, low. This'll be useful if 
any of the remaining AUTO programs 
need to be booted in medium, as the ST 
doesn't read the DESKTOP.INF file before 
activating programs inside the AUTO 
folder (see AUTOGEM for more insight 
on all this). 

KEYCOMBO— Sets up certain key 
combinations to actuate some basic func- 
tions of the ST from the keyboard. 
Alternate-Undo sends a form-feed code to 
your printer; Alternate-Delete blanks the 
screen on your color monitor, presuma- 
bly saving the phosphors of your display 
(this key pairing doesn't function in 
Monochrome); Control-Alternate-Delete 
is like hitting the reset button at the rear 
of the ST and warm starts the machine; 



Control-Alternate-Left Shift-Delete accom- 
plishes a cold start, like cycling the 
machine with the power switch. 

ONEHAND — Advertised as being writ- 
ten primarily for handicapped computer 
users, this program turns the Alternate, 
Control and both Shift keys into toggling 
switches, just like the Caps Lock key. 
While it's impossible to use them during 
some applications (like word processing, 
for example) it is handy for single-handed 
mouse manipulation (by toggling the Al- 
ternate key on and using the arrow keys 
to control the pointer). 

RESET— This changes the function of 
the reset button, causing it to initiate a 
cold start instead of the usual warm start. 
This will clear out normally reset-proof 
programs, like 512K (see TOS programs) 
and some RAMdisks, for instance. 

STSELECT— Lets the user pick from 
the files in the AUTO folder and desk ac- 
cessories to choose which ones from the 
boot disk should be run at boot-up. It will 
rename unwanted AUTO files to .PRX ex- 
tenders and .ACC files to .ACX extenders 
so the ST won't load them in at boot-up. 
As with AUTODATE, STSELECT uses the 
arrow keys for specifying which programs 
are to be loaded, and if the user doesn't 
respond within five seconds, the boot-up 
process continues. 

VERIFY — Shuts down the write verifi- 
cation function of the ST's disk drive to 
expedite writes to disk. In actual testing, 
by copying an approximately 200K file 
from RAMdisk to floppy disk, the ST took 
48.0 seconds with normal verification as 
opposed to 27.5 seconds after running 
VERIFYPRG. 
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Desk Accessories 

AUTOGEM— The only desk accessory 
in the package, AUTOGEM ingeniously 
allows auto-booting of any GEM pro- 
gram. Formerly, .PRG programs couldn't 
be placed into AUTO folders because 
those programs required that GEM be 
loaded before they are run; unfortunate- 
ly, GEM loads in after the AUTO folder 
boot. 

AUTOGEM takes control of the mouse, 
activating windows and double-clicking 
on icons to initiate the booting of a speci- 
fied program after the boot process is 
completed. This requires you to use the 
AUTOGEM editor to choose or change 
the program to be run, or disable the fea- 
ture altogether. Moving the mouse away 
from the center of the screen before the 
auto-execution process starts, turns the 
option off. 

My only complaint has to do with the 
automated mouse movement, which is in- 
credibly slow during AUTOGEM. Grant- 
ed, the first few times you see it do its 
magic it's a kick to watch the phantom 
pointer movement, but it's a novelty that 
soon wears out. The function of this pro- 
gram is to boot up the predetermined file, 
and if you're like me you want that to oc- 
cur as soon as possible. Hopefully, they 
will pick up the pace of the mouse in the 
future. 

GEM Programs 

AUTOFOLD— With all the AUTO files 
provided on this disk, it would be help- 
ful to prescribe the order of execution. 
For instance, there are cases where you 
will want certain programs to load before 
others so their features will provide the 
most benefit — having HIGH set up the 
resolution ahead of other programs' exe- 
cution, for example. AUTOFOLD lets you, 
the user, choose the sequence of execu- 
tion and re-orders the folder for that 
line-up. 

FILELOCK — For security in your disk 
data, you can code them with this pass- 
word system, cutting off unwanted snoop- 
ing. Up to three passwords can be 
employed to provide maximum protec- 
tion. Once a file is locked, there is no way 
to unlock it without the proper password 
entry. 

On the negative side, FILELOCK will 
wreck your file if the improper password 
is used. This means that you must take 
special care to re-enter your passwords 
verbatim, and keep FILELOCK and your 
"locked" files out of unwanted hands; at 
the very least, you should make backups 
of all files you lock. 



TOS Programs 

512K — Why would someone write a 
utility that would take your one-Meg ST 
(or more) and emulate a 51 2K ST? Well, 
some programmers have been a bit shod- 
dy in doing their chores, using some im- 
proper addresses in their code. The end 
result could prevent a one-Meg-plus user 
from running an application. 

To 512K's credit, your machine will run 
like a 520 ST and bring the poorly- 
programmed file back to the land of the 
usable. Actually, the consumer of the bad- 
ly written program should request that 
the developer update the software to 
make it compatible if the user upgrades 
the machine they use, and hopefully the 
company will comply. With that in mind, 
a program like 512K would become ob- 
solete. Realistically, there will be situations 
when its availability will save someone a 
good deal of time and trouble waiting for 
the update, though as time goes on the 
loss of available RAM may become the 
resulting limitation to the user. 

KEYCODE — -This program returns to 
the screen the ASCII code and the key- 
board scan code for a struck key. Both of 
these values are helpful to programmers, 
particularly with some "same" keys hav- 
ing different values. On the ST, both the 
"1" key on the top row of the main key- 
board and the "1" on the numeric pad 
have the same ASCII value (which KEY- 
CODE displays as 0x31), but different 
scan codes (0x02 and 0x6D, respectively). 
I can't help but think that this program 
would've been a little more efficient as a 
desk accessory, where the user — especially 
a programmer — wouldn't have to back 
out of an application to get a key's value. 

TTP Programs 

FC — Another programmer-focused file, 
this compares two different programs, de- 
termines the bytes that don't match be- 
tween them and lists them to the screen. 

FDEL — Here's another security-minded 
utility that will delete a file with no 
chance of recovery. The ST's normal 
procedure for deleting a file doesn't ac- 
tually overwrite the file (a file's location 
is marked as being usable for future disk 
writes and, provided that those sectors 
haven't been written to, the data exists in- 
tact), and programs are available for "un- 
deleting" files that haven't been written 
over. FDEL goes a step further by filling 
the file's previous location with garbage 
characters, ensuring that someone doesn't 
come along and spill its valuable contents 
out for all to see. 

GREP — As with the Search command 



in a word processor, this file searches any 
other files for a particular character or 
string. It would've been a bit easier to use 
if examples of the various commands 
were provided, but that is the general sit- 
uation with TTP programs; they don't 
support mouse use, often require the user 
to use a cryptic command set and fre- 
quently must be played with on a trial- 
and-error basis before the user gets the 
best out of them. 

HEADER— These next two are, again, 
programmer-oriented. HEADER takes the 
target file and tells you the length of the 
Text, Data and BSS segments of a file, as 
well as the symbol table length, if one is 
used. And .... 

HEX— Takes any file and very neatly 
displays it in hexidecimal. 

TOUCH— This is an interesting appli- 
cation: It will "touch" the desired file, 
thereby stamping the file with the system 
time/date (or a user-specified time/date 
figure for those without a clock card), 
helping you to track the latest version of 
a file. Especially beneficial when used in 
conjunction with AUTODATE to set the 
system up. 

UNHIDE — Lastly, this lets you get into 
the guts of the file directory. You can set 
or remove flags for hidden, read/read- 
write and/or system attributes on the disk. 

The STuff package also contains a pro- 
gram called PATCHER, a utility that is 
used to insert bug fixes, commonly called 
"patches," during future upgrades. This 
will enable Michtron to reduce the cost 
of upgrading by not having to send an en- 
tirely new disk to each owner. Factory 
Programming (the company that created 
STuff and some other fine programs for 
Michtron) has put PATCHER into the 
public domain and claims they will in- 
clude it with all future releases. That's a 
consistency that's good to hear of, very 
reassuring to owners of Michtron/Facto- 
ry products when they consider support 
for their purchases. 

For obvious reasons, Michtron has left 
the STuff disk unprotected so you can 
place any of the programs on boot disks, 
frequently used disks or — given that you 
own one — install them on a hard drive. 
This isn't an invitation to pass on the files 
to your friends. Please respect this action 
by Michtron, particularly with the low 
cost of the package; better, encourage 
others to pick up STuff if there is anything 
in it that strikes their fancy. I found a few 
programs that are useful on a day-to-day 
basis; others you'll call up once in a blue 
moon. Still, it's a minute price to pay for 
all that STuff. 
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Phantasie III: 
The Wrath of 
Nikademus 




VIEW 



By the time most sequels reach their 
third installment, typically even the 
best series has been stripped of any sur- 
prise and originality it might have had in 
the first place. Even the third Star Wars 
was somewhat of a letdown. Such is not 
the case, though, with this new game. 
When I reviewed its two prequels, I 
declared them to be light-years beyond 
any previous fantasy games. What is truly 
surprising is that Phantasie III is light-years 
beyond its two landmark predecessors. 

I hardly need to go into the specifics 
of play. Phantasie III continues the story- 
line begun in I & II, basically a rich blend 
of dungeons and dragons, swords and sor- 
cery. Nikademus is still on the run, still 
spreading his own special brand of evil. 
And you are again pursuing him. Or, 
rather, your characters are. A number of 
characters can be created, each random- 
ly assigned attribute values increasing in 
direct proportion to the warriors' 
strength, intelligence, charisma, luck, dex- 
terity and constitution. Up to six are then 
banded into a group, armed and trained 
and put on the road to begin their (and 
your) adventure. 

Moving out of the town of Pendragon, 
you cross the countryside, battling scores 
of creatures in the forests and dungeons 
of the land, stopping at inns and towns 



to rest and build strength. Successful 
quests are rewarded with gold and ex- 
perience points; unsuccessful ones are re- 
warded with death. The kingdom you 
explore is vast and full of dark dungeons 
and dangerous monsters, as well as a 
number of hidden worlds not immediate- 
ly discovered. But rest assured that if you 
manage to explore all the nooks and cran- 
nies filling the data disk, you will meet the 
evasive Nikademus and battle him on his 
own turf. Of course, this climax is days 
(both real-time days and game-time days) 
away. But it won't take any time at all to 
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Reviewed by Steve Panak 



learn the simple, intuitive commands 
you use to control your destiny. 

The mouse is used for nearly all in- 
put, which is done on carefully 
designed and efficient displays, con- 
taining logical defaults to speed repeti- 
tive selections. For example, when 
creating a character it is assumed that 
you will continue to create characters 
of the same race and profession until 
you choose otherwise. Very useful, as 
you might discard scores of fighters 
until you get one with randomly as- 
signed attribute values that satisfy you. 
Nearly all screen displays have been 
redesigned, adding more detail, color 
and action. The status of your band is 
displayed at all times, graphically, on 
the screen. Each member's body is dis- 
played with wounds indicated as to 
body part and degree of injury. A red, 
broken left arm can render a charac- 
ter incapable of using his bow. A re- 
moved head can render a character 
incapable of even simpler tasks. 

The list of improvements continues. 
Party members can be assigned to 
ranks in the group Placing your weak- 
er wizards at the back protects them 
from the brute force of the melees. You 
can save more than one dungeon map 
and your party can accumulate up to 
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a billion gold pieces. You are allowed to 
distribute items upon entry into a town, 
and trade items among party members, 
rectifying a clumsy fault in the two earli- 
er Phantasies. A couple of more spells 
have been added, as well as the ability to 
target spells at specific ranks. Bows are ad- 
ded as a weapon, and you can selectively 
increase a character's nine skills by specif- 
ic training as he rises in level. You have 
more control over the destiny of your 
characters. 

The documentation is equally superb. 
The 25-page manual completely describes 
all aspects of game play and program 
operation. Tables and charts simplify de- 
termining the allowable spells and 
strengths of the various creatures inhabit- 
ing the Phantasie universe. Two handy ap- 
pendices provide impatient players with 
quick start information and veterans with 
a list of the enhancements contained in 
III. An ST reference card contains 
machine-specific information, which I felt 
was a little brief, but adequate overall. 

In fact, this game is so close to perfect, 
I have to dig really deep to find any fault. 
But here goes. While I liked the ability to 
copy both game and data disks, the re- 
quired input of answers to questions on 
the manual's contents multiple times dur- 
ing a play session was distracting — even 



after we had memorized all the questions. 
In the prior two versions, upon casting a 
spell, menus listing the available spells for 
each character indicated those spells 
which were not available due to weakness. 
In III you must try to use the spell only 
to be told your character is too weak. 
Menu windows open up over the status 
display, making it difficult and time con- 
suming to administer healing spells and 
magic potions to a weary group, as you 
often must exit the routine in order to 
check the status of your men. Finally, 
although you are able to transfer your 
characters from I & II to III, I was unable 
to do so with my loyal group, who had 
finished both of the previous adventures. 
The transfer program worked perfectly 
with other data disks, just not with the 
one I wanted to use. However, we simply 
recreated our warriors and played despite 
the annoyance. 

So, if you can't tell by now, I'll make it 
known: I loved this game. Phantasie III 
skillfully mixes a great story line filled 
with plenty of action and adventure, a 
number of improvements and a user in- 
terface second to none. As a stand-alone 
game, or the climax to the series, it is a 
must for all adventurers. I can only hope 
that we will get to experience more Phan- 
tastic games like this one. 
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You are no doubt aware of the Night- 
mare on Elm Street movies and their 
popularity. As graphic and controversial 
as they are, there's one thing that keeps 
the public coming back to sequel after se- 
quel: suspense. If you can keep people on 
the edge of their seats with "things that 
go bump in the night" and such, you'll 
have a hit. 

Ladies and gentlemen, welcome to 
Nightmare-ware on ST Street. . . 

Dungeon Master, a slick, new adventure 
from FTL Software, has taken the ST 
world by storm. "New" is a relative term 
as ST users may -recall a demo FTL 
released — about two years ago — that first 
demonstrated what they were working on. 
It showed up in the databases of the 
ANALOG/Atari SIG on Delphi in June of 
'86 as the Firestaff Demo. Since then, 
they've switched to a different language, 
for added speed, and it's obvious they 
haven't wasted any of that time. 

The final result is a suspenseful blend 
of strikingly colorful graphics and strong 
action, but by far the finest aspect of DM 
is that feeling of fear and apprehension 
you get wondering what's going to pop 
out from around the next bend. Count- 
less DM enthusiasts — and my hand is 
raised here, also — have admitted to ac- 
tually being startled by a surprise visit 
from one of the ghoulies lurking in the 
multitude of rooms in the castle. 

The software takes quite a while to load, 
understandably due to the custom rou- 
tines FTL has employed to get more than 
16 colors on the screen at once, as well 
as the size of the castle you'll be rummag- 
ing through. The added hues are used to 
smooth out the shading of the surround- 
ings, but, most importantly, to make the 
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assaulting creatures look as life-like as 
possible. And they do! 

Couple that with the digitized sound ef- 
fects, which accompany each offensive at- 
tack you or the monsters initiate and you 
get the spirit of being there. For instance, 
they've even added comical "gulps" and 
"ooofs", when you eat something or ac- 
cidentally run into a wall with your party. 
Having one of your party killed off brings 
a heart-wrenching moan from the moni- 
tor speaker; an audible assist as you will 
probably be too busy slinging your 
weapons in combat to see that member's 
health indicator bars drop down. It's an 
involving experience, to say the least. 

Wrassle in the Castle 

At the onset of the contest, you wander 
through the Hall of Champions, a cham- 
ber of characters who have failed in their 
past attempts at defeating the evil Lord 
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Chaos. As the story that accompanies the 
documentation attests to, you are a young 
apprentice to the Grey Lord. As you fur- 
ther discover, Theron's mission is to over- 
see four heroes in the quest to retrieve the 
Firestaff, a stepping stone to defeating 
Lord Chaos. 

Each Champion has their portrait hung 
on the wall of the chamber and clicking 
on the picture brings a screen detailing 
their attributes and cache of weaponry. 
You can restore them as they are, or resur- 
rect them under a different name, though 
at a lower ability level. As with most ad- 
ventures of this genre, you gain ex- 
perience points in certain areas, or actu- 
ally avocations — such as Priest, Wizard, 
Ninja, etc. — as you successfully fend your 
way deeper in the maze of rooms and 
levels. 

Also, as is common in this kind of 
gameware, you gather necessary com- 
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ponents — be it a weapon, key, informative 
scroll or vital nourishment, among other 
items — to keep the party healthy and on 
top of the onslaught. So as not to dis- 
courage the novice adventurer, the first 
levels are the easiest — providing a nice, 
smooth learning curve for getting used to 
the surroundings of the castle and the 
software's controls — with each successive 
level adding more opposition in the way 
of harder-to-kill meanies and intricate 
mazes. I've victoriously battled my way 
into level 4, though I've been told I have 
a ways to go; there are in excess of ten lev- 
els, enough to keep a player busy for some 
time. 

I think icon, I think icon .... 

Playing DM is a treat in comfort; every- 
thing is icon-driven and mouse- 
controlled, so there's no call for any typ- 
ing (even if you choose new names for 
your champions at the start). I've always 
found the burden of typing commands in 
text adventures to be a tedious exercise 
that generally accounted for my past ap- 
prehension over playing them. 

Also unlike text adventures, picking up 
an object is as simple as moving the 
mouse pointer (in the shape of a hand) 
to the object on the screen and clicking; 
click again to drop it. You can even use 
the acquired item as a weapon by hold- 
ing its icon in the center of the screen and 
clicking, which causes the character hold- 
ing it to throw it. 

The viewer accurately shows the per- 
spective of how your party views the area 
around it; if items or creatures are down 
the hall a bit, you'll see them in their 3-D 
rendition. And those surroundings are 
nicely garnished with occasional embel- 



lishments, like a patch of algae or miss- 
ing mortar on the walls and puddles on 
the floor for added realism. 

If you need a bite to eat, just click with 
the right button on the icon of the select- 
ed champion at the top of the screen, 
click on the object you want in the back- 
pack (which holds 17 objects per party 
member), carry it to the mouth icon and 
click. . .glup. . .and the player's food in- 
dicator bar jumps up to a more accepta- 
ble level; the same occurs to satisfy thirst. 

You also have areas on-screen for the 
preparation of weapons or magical ob- 
jects. There are two hand icons for hold- 
ing objects, and placing an item in the 
right hand enables it for activity, like 
slashing with a sword or flinging a throw- 
ing star. As well, there are pockets for 
holding small objects (like a compass or 
rabbit's foot) and locations for clothing 
and armor (such as a helmet or chain 
mail). 

Abracadabra 

One other essential thing you have in 
your defensive favor is magic spells. At the 
far right of the display, there is a box with 
symbols in it and four buttons, each with 
the name of the party members in it. 
Clicking on one of the names and follow- 
ing that by selecting (also with the mouse) 
a series of symbols will have that person 
chanting matching spell syllables. Certain 
combinations of symbols effect different 
results: fireballs, poisonous missiles, a 
mystical torch for lighting your way, heal- 
ing, etc. The higher the level of "mana" 
your characters have, the stronger and 
more frequently they can recite the incan- 
tations with better results. 

I know all this sounds overwhelming, 



but keep in mind that learning to use any 
complex piece of software can take a lit- 
tle bit of getting used to — keep in mind, 
it's the program itself that's complex, not 
the actual use of it. As I alluded to before, 
FTL has provided ample room for getting 
the hang of the user interface, while risk- 
ing very little damage to your party. 

Dialog boxes for saving the game to 
disk lead your way easily to insure you 
don't waste your efforts. The only com- 
plaint I can make is that you can't reload 
a game on the fly; only at the start of a 
new session or when all of your party 
members have bitten the dust. There are 
times, if you know you are faring poorly, 
that you wish you could get a fresh start 
on the scenario, but for now it's not sup- 
ported in DM. 

That's too bad, because you'll find your- 
self reloading your game saves over and 
over, due to the ruthlessness of a terribly 
challenging variety of attackers. There are 
mummies, oversized mushroom creatures 
called Screamers, poisonous purple 
worms, and many more. All of this gets 
more intense as the contest rages on. And 
to reiterate, the graphics and animation 
of these beasties is fabulous: flailing arms, 
fang-filled mouths and slithering bodies 
slinking around the maze at every turn. 

The foundation of 
the dungeon 

According to Wayne Holder, President 
of FTL, the work that went into the DM 
software will result in a toolbox of sorts, 
giving them the ability to create other ad- 
ventures in a multitude of venues. Chang- 
ing the graphics data file, for example, can 
alter the arena of play from the DM cas- 
tle to deep space. This configuration will 
permit them to come out with these 
games quicker, cleaner and cheaper than 
a product that starts from scratch. Holder 
stated, albeit optimistically, that their in- 
tentions are to bring out four to six games 
of this sort each year, with the first one 
coming after they work all the wrinkles 
out of this potentially powerful develop- 
ment system— possibly by the end of 198& 

Keep in mind that you can't possibly get 
the feel of how well the game looks or 
plays, or understand all the nuances of the 
product by just reading the ran tings of this 
satisfied reviewer. My advice is to run to 
your nearest computer store and buy a 
copy of this gem to see for yourself. As I'm 
sure you'll agree, it's worth every penny. 

In your haste though, don't forget one 
thing: keep an eye peeled for movement 
around each and every corner, just to be 
safe. . .you never know what's hiding there! 
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The product 
is pretty 
functional, 
but choices 
in the 

marketplace 
are ever 
increasing 
— better 
quality 
digitizers 
can be 
found. 




Personal computer owners are show- 
ing an increased interest in graph- 
ics. A look at the SIGGRAPH show in 
California, a major computer-graphics 
show in which more and more small com- 
puter works are appearing, is an example 
of this occurring. The computers are go- 
ing up in what they offer ability-wise 
while they descend in price. This means 
that more of the masses are able to par- 
take in the artistry. Among the tools that 
are gradually making their way on the 
scene are digitizers like Hippo's and Dig- 
ital Vision's Computer Eyes. Hippo's Hip- 
poVision digitizer has been picked up by 
Navarone and we'll see how the subse- 
quent ST Video Digitizer now fares in com- 
parison. 

First a little history: Hippopotomus 
Software, among the many products it 
came up with since the introduction of 
the ST, introduced a digitizer that was to 
its benefit, the first to be released to the 
public. It had all the appearances of be- 
ing rushed to market, as many buyers of 
the HippoVision complained of software 
crashes and poor picture quality. 

Shortly thereafter, amidst many rumors 
of their shaky survival, Hippo phone lines 
were ominously vacant, and the compa- 
ny disappeared from the scene. Needless 
to say, this left many unhappy consumers 
in the wake. Navarone, previously known 
as the maker of the Timekeeper clock 
cart, announced that it was picking up the 
licensing of both the Hippo video and au- 
dio digitizers. Navarone took the tooling 
it had in place from the clock cart 
manufacturing to package the digitizers, 
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giving a similar appearance to its 
products — as well as saving some bucks 
by using an existing production system. 

Specific to the video digitizer, it rewrote 
the software entirely in an attempt to 
eliminate the problems that came up with 
the original version. Unfortunately, those 
who already bought the device while it 
was being offered by Hippo are basically 
stuck with what they have; but Navarone 
will upgrade the software for a cost of $19. 

I never had the opportunity to use the 
original HippoVision package, but I did 
hear enough from those who used it to 
get the idea of its quality. Though it's im- 
possible for me to compare the two 
devices, I can say this: While changes had 
been made to the device and the software, 
the digitizer is still not up to the quality 
that's necessary for a graphics-dependent 
device like this one. 

Setting Up 

To get started, you take the cartridge 
(which accepts video inputs via the RCA 
socket connector) and slip it into the car- 
tridge port on the ST. To the designer's 
credit, the unit doesn't require external 
powering taking the necessary voltages 
from the ST itself, thereby eliminating a 
further tangling of cords. Booting up the 
software after completing the hookup 
from a video source brings about auto- 
matic synchronization with a dialog box, 
appearing if there are any discrepancies. 

Aside from the RCA socket, the only 
other thing that is exposed to the user is 
a thumb wheel for adjusting picture 
width. All of the pictures accompanying 



this review were taken with the thumb 
wheel fully counter-clockwise, which cor- 
responds to the widest image. As we'll 
mention later, this didn't eliminate the im- 
age not taking up the entire screen or 
having what appears to be garbage on the 
edge in certain instances. 

The disk that comes with the package — 
smartly unprotected so you can make a 
backup — contains various buttons on its 
desktop for picture saves/loads, specifying 
what format you want to save the pictures 
in (DEGAS or Neo), on-screen command 
help, a choice of Digitizing or Animating 
modes, full-screen display of the picture 
that currently resides in memory, as well 
as a few adjustments to the status of pic- 
ture acquisition parameters. 

The other tweaks you can enact concern 
Contrast, Brightness and Sync Level. The 
first two are easy to comprehend as they 
relate to similar controls on a television 
set; in fact, the sync control is quite the 
same as on a TV. It allows the user to cor- 
rect any shimmering that may arise due 
to poor synchronization, though with the 
software synching at boot-up it's very likely 
that this won't need any further adjust- 
ments. These three parameters can also be 
altered during digitizing using the ST's 
number pad, which lets you see the effect 
on the image directly. 

The software operates in either low or 
high resolution. In both modes, you have 
a choice of two, four or eight levels of gray 
(the manual states that your actual break- 
down for high resolution is three-, five- or 
ten-gray levels), though you can alter the 
low-resolution palette to whatever you 



choose from any of the ST's 512 colors. 
This is accomplished by picking the Palette 
button on the on-screen desktop and mov- 
ing the sliders to vary the hue as you would 
from the ST's Control Panel. As an exam- 
ple of the annoyances I alluded to earlier, 
if you click your mouse too quickly in 
changing your palette, you'll find the soft- 
ware will crash, bombing you back to the 
main desktop. It's much easier and more 
efficient to employ a paint program like 
DEGAS, DEGAS Elite or Neochrome to 
tailor the palette to your liking. 

The Navarone unit does have something 
in its favor with the speed of its hardware 
in grabbing images. They claim it can take 
in one gray level per frame (l/60th of a se- 
cond), so if you have the programming set 
for eight-grey levels it will — according to 
their figures — take 2/15ths of a second to 
acquire the picture. It's quick, but I 
wouldn't say it was that quick: In a two- 
gray-level setting pictures pop onto the 
screen rapidly, but not too fast to prevent 
you from stopping the process to see a 
desired shot; set to eight gray levels, it will 
be a few seconds between image refresh- 
ing. From this speed, they've built in an 
Animation mode for getting a sequence 
of digitized shots. 

To do this, you click on the Animate but- 
ton on the program's control panel, and 
you'll get another dialog where you can set 
the delay between each acquisition, how 
many "frames" you want to grab and what 
you are going to call your "movie." From 
here, you can also start the anima- 
tion/digitization process, view the sequence 
and save it to disk. The restriction you have 
with animation is that your image can only 
be made in a two-gray-level setting, which 
results in a not-too-detailed graphic. 

The other major problems I came 
across while testing the unit out had to do 
with the actual digitized images them- 
selves. When receiving pictures in eight 
gray levels, things generally seem to be 
okay. In the other modes, you seem to get 
a tinier version of the picture, not only on- 
screen but in actual picture-size also. Many 
times, the resulting shot has a stripe of gar- 
bage lines running down the right side of 
it that must be cropped off with a paint 
program to get a clean representation of 
the actual subject (see the four-level shot 
of the stuffed cat). 

I'm not one to enjoy giving a bad review 
to a product, but in the case of Navarone's 
ST Video Digitizer it's unavoidable. The 
product is for the most part functional, 
but I find that the choices are increasing 
in the marketplace to allow the ST user an 
opportunity to find a better quality 
digitizer. 
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Attention 
Programmers! 




ST-LOG Magazine is interested in programs, articles, and software review sub- 
missions dealing with the Atari home computers. If you feel that you can write as well 
as you can program, then submit those articles and reviews that have been floating 
around in your head, awaiting publication. This is your opportunity to share your knowl- 
edge with the growing family of Atari computer owners. 



All submissions for publication, both program listings and text, should be provided 
in printed and magnetic form. Typed or printed copy of text is mandatory and should 
be in upper and lower case with double spacing. By submitting articles to ST-LOG 
Magazine, authors acknowledge that such materials, upon acceptance for publica- 
tion, become the exclusive property of ST-LOG Magazine. If not accepted for pub- 
lication, the articles and/or programs will remain the property of the author. If submissions 
are to be returned, please supply a self-addressed, stamped envelope. All submissions 
of any kind must be accompanied by the author's full address and telephone number. 



Send your programs and articles to: 
ST-LOG Magazine 
P.O. Box 1413-M.O. 
Manchester, CT 06040-1413 



BOOT UP 
TO BIG SAYINGS! 




SAVE TIME AND MONEY 
SUBSCRIBE TO ANALOG 

SAVE $14 OFF THE 
COVER PRICE WITH 
THE CONVENIENCE 
OF HAVING ANALOG 
DELIVERED DIRECT- 
LY TO YOUR DOOR 
BEFORE IT EVEN HITS 
THE NEWSSTANDS. 
GET THE MOST OUT 
OF YOUR COMPUTER. 
SUBSCRIBE TO 
ANALOG 
TODAY 



1 YEAR FOR ONLY $28 

SAVE $14 OFF THE COVER PRICE 

1 YEAR WITH DISK ONLY $105 



□ 1 YEAR @ $28 - SAVE $14! 
FOREIGN - ADD $7 PER YEAR 

□ 1 YEAR WITH DISK @ $105 
FOREIGN - ADD $15 PER YEAR 

□ PAYMENT ENCLOSED □ BILL ME 
CHARGE MY: □ VISA □ MC # 



MCHWY 



DCHWY 



EXPIRATION DATE SIGNATURE 

MONEY BACK ON ALL UNUSED PORTIONS OF SUBSCRIPTIONS IF NOT SATISFIED. 



NAME 



ADDRESS 



CITY 

MAKE CHECK PAYABLE TO L.F.P., INC., P.O. Box 
26,1988 . Your first issue will arrive in 6 TO 8 weeks. 



STATE 



ZIP 



N. Hollywood, CA 91615. Offer expires OCTOBEH 
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Spectrum 512 
by Trio Engineering 
The Catalog 
524 Second Street 
San Francisco, CA 94107 
Orders: (800) 443-0100 
Customer Service: (415) 957-0886 
Low or Medium Resolution 
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veryone has a little artiste in them. For that reason, paint programs have been 



^■heavily in demand — perhaps the most popular category of software of ST 
users — since their introduction. First into users' disk drives was the NeoChrome 
program provided by Atari to the first ST buyers; that was followed by N- 
Vision/Paintworks, Tom Hudson's DEGAS and DEGAS Elite. Those programs have 
satisfactorily carried ST users — until now. 

An engineering company from Massachusetts called Trio Engineering — made 
up primarily of three Russian emigrants — has taken the ST to limits of color dis- 
play never attained before. To reach this programming pinnacle, they first sought 
to determine the limits of the ST's internals, through the use of various test gear. 
The resulting program, marketed under the moniker Spectrum 512, brings all 512 
colors to your screen simultaneously, giving you the ability to make any picture you 
paint that much more detailed in shading, and, in turn, more realistic. In fact, 
you can place more colors on a scan line — 48 of them — than was supposedly pos- 
sible for the entire screen. 

But to limit the description of the program to just the additional colors it gives 
you would be unfair. They have, by virtue of that engineering, expanded the abili- 
ties of a paint program to include smoothing of lines and curves — 
long acknowledged as a major limitation of computer graphics — through the use 
of a process called "anti-aliasing." Anti-aliasing takes what would normally be a 
jagged line and shades it with darker pixels of the same color to give it the ap- 
pearance of being smoother. Circles look like circles; angular rays take on less of 
a staircased form. 

Another effect of the expanded palette allows Spectrum to shrink down blocks 
of a graphic with very little change in resolution through what is called "pixel 
averaging." This lets you take a full-sized picture and scale it down without losing 
much of the original's quality. The process lets you work with larger shapes at first, 
then size them down to fit into a picture, or to place text or fill patterns around 
it. You can also change the original's shape (not unlike DEGAS' stretch command), 
which makes a change of perspective simple. 

To top it off, with so many colors to play with, Trio's work has provided another 
powerful feature: the Gradient Fill. You pick a starting and finishing color, and 
Spectrum will fill (in a variety of forms) the chosen area with all shades between 
those two colors. This makes it easier to build a scene with gradual color altera- 
tions, such as you'd find in a sunset panorama. 

The last few functions I mentioned just touch on the more innovative and diverse 
abilities that reside in Spectrum; it still offers the primary graphic processes: fills, 
magnification areas of the screen for touch-up, simple shape creation (line, poly- 
gon, circle and ellipse), and block copies and moves. With the oodles and oodles 
of features that Spectrum provides, the most difficult part is in learning how to 
get to each nook and cranny, some located in the depths of the program. 

For example, a simple command like loading a picture actually has two options: 
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If you click on the LOAD selection from 
the main menu with the left button of the 
mouse, the program will bring up a file 
selector to choose which file to display; 
clicking on LOAD with the right button 
brings up a dialog box prior to the file 
selector, prompting you for the type of 
file to load, as Spectrum can import DE- 
GAS and Neo screens, as well as .IFF and 
HAM (Hold And Modify) formats from 
the Amiga. With the 4,096 colors availa- 
ble on that computer, Spectrum uses a 
dithering algorithm that tries to retain the 
original picture's quality. They claim it 
simulates 3,000 colors on the ST. 

Another basic example of the intense 
user interface is in the primary use of the 
right button from the workscreen. If you 
hit the right button in the upper half of 
the screen, you bring up the main menu; 
hitting the right button on the lower half 
gives you access to the color matrix, which 
contains all 512 colors; and using the 
right button within ten pixels of either 
side of the screen (when a palette is 

Once you learn how to work 
the user interface, you can form 
masterpiece after masterpiece, 

present) changes the active color to the 
one next to the pointer. Starting to see 
what you're up against? It's certainly not 
the fault of the programmers — they had 
to do a lot to give the user the access to 
all of these wonderful features — but 
shows how much more you have to work 
to get the most out of this product. 

The manual doesn't help much. I feel 
confident that the tutorial section (which 
runs you through the features by instruct- 
ing you, step-by-step) will assist those who 
are just starting out with Spectrum; and 
experienced users will be able to go to the 
area in question by using the Table of 
Contents and the Reference Section (a 
run-through of the various commands, in 
order of how they are placed on the main 
menu, in addition to their many sub- 
menus). There are even two additional ap- 
pendices to aid you: a discussion of the 
Gradient Fill technique by Boris 
Tsikanovsky, Spectrum's programmer; and 
a short tutorial by Darrel Anderson, An- 
tic's favorite artist who created most of the 
first Spectrum art pieces that were seen 
by ST users before Spectrum's release. All 
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that is well and good. 

The problem is that the manual is too 
"chatty," a situation that too often had me 
hoping they would just get to the point. 
Also, there is a propensity for cutesy 
banter that I find too distracting. I sup- 
pose some folks would find this approach 
more friendly and comforting, but it only 
serves to lengthen an already involved 
learning process. 

Finally, you'll find an inordinate 
amount of redundancy. Granted, many 
users need a bit of a push with a program 
of this caliber to absorb all of what is 
offered; yet, driving a point home repeat- 
edly gets to be annoying, even insulting. 
Being told over and over that the undo 
key will cancel the effects of the last oper- 
ation sinks in after just one or two tries, 
especially when running through the 
tutorial. My advice — and this goes for 
many software releases, not just this 
one — would be to include a reference 
card that could rest atop the computer. 
No one wants to have to dig up their 
binder every time they need to find the 
use of a command, particularly in the 
heated passion of artistic creation. 

On the whole, Spectrum shines 
through these minuscule misgivings, as 
the program proves itself as a tight piece 
of code. Once you master the user inter- 
face, you can form masterpiece after 
masterpiece, as the programming offers 
so much to assist the user, such as having 
intermediate shades automatically appear 
on some palettes. You often lose the feel- 
ing of working on a computer. 

What is most exciting in the making of 
Spectrum is that its programming break- 
throughs can easily be used to enhance 
other graphic-based programs for the ST. 
There is talk of improving animation 
quality and design/engineering programs 
(such as CAD 3-D). So what started in the 
programmer's view as a "static display 
program" will likely have a far-reaching 
effect on the future of ST programming. 

An example of how this has already 
happened is Trio's Digispec accessory 
($34.95 from Trio Engineering, P.O. Box 
332, Swampscott, MA, 01907; (617) 
964-1673). It runs under the Com- 
puterEyes system software and expands 
that digitizer's quality by a quantum leap. 

There are very few products that I can 
consider a must-buy for the ST. I can safe- 
ly say that if you have any intention of let- 
ting your artistic stylings run free on the 
phosphors of a monitor, Spectrum is the 
medium where your fingers should do 
that running. 



98 



August 1988 ST-Log 



REVOLUTIONARY 
NEW PRODUCT 



• Imagine Saving almost any game at any point, then being 
able to return there as many times as you like. 

• Imagine the Ultimate Back-up Utility that actually UNPROTECTS 
programs as it copies them. Lets protected programs be 
stored as files, run from a hard disk or even be transmitted 
over a modem. ... 

• Imagine saving three or more protected single sided disks on 
just one double sided disk. 

• Imagine Instantly switching back and forth between two 
different programs, games, utilities or business applications. 

Now Stop Imagining and get Switch/Back. 
It can do all this and more. 
Switch/Back is a revolutionary new hardware and software 
package that lets you get more from your ST MUCH MORF 
Switch/Backs gaming features lets you instantly save most games 
then continue playing. If you get in trouble you can switch back 
to where you were as many times as you like, 




REQUIRES at 

least 1 meg. of RAM 

(or a Megadlsk or Polydisk. Cartridge) 



BACK-UPS -Switch/Back can work with your favorite back-up 
program and allow you to save whole protected disks to files for 
archival purposes. It can also automatically unprotect a 
program and save it as standard file. This method works on 
hundreds of ST programs and it allows you to run the files directly. 
Its perfect for running protected programs off a hard disk. It 
creates standard TOS files, that can be stored together on disks 
or even transferred by modem. 

SWAP - Switch back lets you load just about any two programs 
into your ST and switch instantly between them. It works with 
games, business programs, utilities, compilers, etc. Although only 
one program is running at a time, the other is available instantly, 
right where you left off. 

The Switch/Back hardware plugs into your printer port for easy 
use (It has a pass through connection for your printer too.) 
Switch/Back requires at least One Meg of memory 
(Or a Polydisk or Megadisk) ONLY $69.95 



ST Protection Techniques 

Finally ST Copy protection techniques are revealed. 
This complete book and disk package details ihe state 
of the art in ST Protection methods and much, much 
more. 

The Software Included with the book provides many 
powerful features like the AUTOMATIC PROGRAM 
PROTECTOR. This easy to use Utility allows you to protect 
ust about any ST program. \bu can choose a 
combination of protection methods like encryption, 
checking custom disk formats, password protection or 
a limited use option that makes the program self- 
destruct after running a preset number of times. 
The book includes topics such as Phreaking, Logic Bombs, Hardware 
data keys, the legal aspects of piracy and software protection. Custom 

disk formats. Pirate Bulletin boards and much more. 

In addition it contains reviews of the popular ST back-up programs and 
detailed explanations of ST disks and drives. #>c 
ST Protection Techniques (Book and disk package) only 9O7.7O 
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COLOR COMPUTEREYES" 
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Incredible COLOR video digitizer. • The first and only full color digitizer 
for the ST • Uses standard video inputs like video camera. VCR. or video 
disk • Works in all ST resolutions. Low res provides 16 shade black ana 
white or full color pictures. • Pictures can be used with Degas 
Neochrome, Powerprint and others. • Automatic calibration of contrast, 
brightness and white balance. • Plugs into cartridge port for easy set-up. 
• Capture your picture or that of your favorite star. ONLY $199.95 
SPECIAL OFFER - Buy both Computereyes and Powerprint and SAVE 2U.UU 
from the total. 
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The worlds most inexpensive clock 
cartridge. Finally its affordable to 
keep your time and date accurate. 
3 year battery included. ONLY $24.95 

MEGADISK Ultra high speed solid stale disk drive •500% 
Faster than a Hard Disk • Provides almost instant booting • Like a RAM disk 
that's always loaded with your favorite programs and ready to use • One 
megabyte of Solid State storage • Built in battery back-up in case of 

^ME^ADISKis actually one megabyte of RAM that simply plugs into your 
cartridge port. It acts as an added disk drive that's ultra fast and always 
ready for use. Like a Hard disk, MEGADISk won't loose its memory when 
your computer is turned off. It comes with its own power supply and 
battery back-up system so its Independent of your computer. 

Meaadisk can be configured according to your needs. • Set it up as 
one large disk • An 800K double sided disk and a 200K hardware print 
buffer • Or as two 400K single sided disks and a print buffer 

Megadisk will work fine with your current system whether you have a 
hard disk and two drives or you're just getting started. 

Meaadisk is perfect for those who want the high speed of a hard disk 
(or a lower price. Its even better for power users or software developers 
who may already own a hard disk and two drives but want extra speed 
and power. Megadisk can also emulate other cartridges for testing and 
back-up. In addition Megadisk can be used with Switch/Back to allow you 
to instantly jump between two full size one meg $900 05 

applications. ^ ^ 

Price Subject to change 

Megadisk Clock Option - Adds a Clock/calendar card to your Megadisk 
cartridge. Contains replaceable Three year battery 29.95 

POl VCl iSk Polydisk is a 512K version of a Megadisk. Polydisk gives 
you the same fast boot features, the high speed access, and Ihe print 
spooler. Polydisk has a power supply (like Megadisk) but does not contain 

° Note Those wtfh only 512K of main memory can use Switch/Back with a 
Polydisk, just like those with one Meg. 

Polydisk (512K Solid state drive) Only $199.95 
(Clock option card is also available for Polydisk $29.95) 



Imagine your picture on a 6 foot poster. Create a business graph that 
can cover a wall. Quality output for posters, t-shirts, news letters, and more. 
POWERPRINT 

Whether it's a photo digitized with ComputerEyes, a masterpiece 
created with Degas, or the winning screen from your favorite game, 
POWERPRINT can print it with unequaled clarity and resolution. PowerPrint 
supports ALL ST resolutions. It prints multiple sizes up to GIANT WALL SIZED 
POSTERS. Print 16 shades for incredible detail. Print the whole screen or 
ZOOM in on just the part you want. POWERPRINT offers unique effects, 
including rotate, mirror and inverse options. Selective shading option 
allows you to print multi-color pictures on any printer by printing one color 
at a time (using color ribbons). Powerprint lets you capture and print 
almost any ST screen. Works with Star, NEC, Citoh, Gemini, EPSON, XM8048 
and compatible printers. ONIY $39.95 
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- High Quality sound digitizer for the ST This powerful 
hardware and software package lets you sample real world sounds and 
play them back on any Atari ST Add special effects like Echo. Reverse, 
looping pitch manipulation, mixing and envelope control. Turns your Atari 
keyboard into a musical instrument to play songs with your digitized 
sounds (also works with any MIDI keyboard). Digisound makes it simple to 
add sound to your own program, too! Unleash the incredible sourtas in 
your ST with DIGISOUND. Supports sampling from 5 to 40Khz, DIGISOUND is 
the choice of the professionals. DIGISOUND was used to create the voice 
in Chessmaster 2000. and other commercial programs, a., q- 

DIGISOUND ONLY VOTf. Tf^ 

DIGISOUND PROFESSIONAL 

All the excellent features of DIGISOUND plus these great extras 

LOGARITHMIC SAMPLING - Special hardware extends the sound quality 

far above the other ST sound digitizers. Logarithmic sampling and 

playback (external amplifiers only) greatly extends the dynamic range 

while reducing distortion and noise. 

Internal Real Time Mixing - Input from a stereo and a microphone so 

you can sing over a tape. £^49 95 

DIGIPLAYER The High powered digisound software can now be 
obtained by those who already own a digitizer for the SI Compatible all 
cartridge based digitizers. Extend the power of your digitizer with 

Di9Player Only $49.95 




24 HOUR HOTUNE - VISA & MasterCard Welcome 

216-374-7469 

Customer Service line (216) 467-5665. Call or write 
lor tree catalog. 



Order by phone or send check or money order to: 
ALPHA SYSTEMS 1012 Skyland, Macedonia, OH 44056 

Include $3.00 shp. & hdlg. (US & Canada). Ohio 
residents add 5V>% sales lax. Foreign orders add 58.00 



CIRCLE #112 ON READER SERVICE CARD. 



This Is All 
The Power 

You Will Evei 
Need In A 

Spreadsheet. 



Isn't it about time that 
you bought a spread- 
A|jpQ\ sheet that takes 

\ advantage of all the 
POWER of the 
ATARI® ST"? That spreadsheet is 
here in LDW POWER.™ 
LDW POWER is a full function 
spreadsheet that boasts an 
extensive array of formats, 
commands, and functions along 
with sophisticated graphing 
abilities. Its Lotus® 1-2-3® 
compatible environment takes 
advantage of the GEM® interface 
allowing you to enter commands 
with the keyboard or mouse. There 
is also a convenient macro recorder 
which actually records keystrokes 
for future use. 



Add to that its incredible speed in 
scrolling, recalculating, and 
copying, and you have one powerful 
tool. 

Just look at these features. 

GENERAL 

• Lotus 1-2-3 Release 2 compatible 

• GEM and Lotus interchangable interface 

• Simultaneous use of up to four worksheet 
windows 

• Condensed display allows 29 rows per 
window 

• Ability to hide columns 

• 18 display formats 

• Customized monetary formats 

• Alignment for labels and numbers 

• Note feature for every cell 

• Close to 300 commands 

• More than 80 functions 

• Five graph types: XY, line, bar, 
stacked-bar, pie 

• Automatic and manual scaling 
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Copy 
LDW Numbers 
POWER: 0.3 sec. 



Copy Recalculation 
Formulas 



■ LDW POWER 
H VIP Professional 

■ EZ-Calc 

13 SwiftCalcST 
0 KSpread2 
H ANALYZE! 



LDW POWER 

SPREADSHEET 





5.3 sec. 



0.6 sec 



Scroll 



42.1 sec 



All brand and product names are registered trademarks of their respective holders 
CIRCLE #113 ON READER SERVICE CARD. 



LOGICAL DESIGN WORKS, INC 



• Optional grid, average/standard 
deviation lines 

• Built-in printing procedure for graphs 

• Metafiles and laser printer (GDOS) 
support 

• Sideways printing program 

• Direct loading of Lotus and ASCII files 

• Saving and retrieving of partial 
worksheets 

• External file link function 

• Password file protection 

• Conversion of files into Lotus format 

• Data Parse command 

DATABASE 

• Quick sort using one or two keys 

• Sophisticated Data Query operations 

• Criteria involving variables and logical 
operators 

• Single and double variable tables 

• Frequency analysis 
MACROS 

• Macro language compatible with 
Lotus 1-2-3 

• Macro recorder 

• Unlimited number of macros 
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$149.95 (suggested retail price) 

See your local software dealer to order or 

(408) 435-1445 for more information. 

®1988 Logical Design Works, Inc. 

All rights reserved. 

Logical Design Works, Inc., 

780 Montague Expwy., #403, 

San Jose, California 95131, 

Fax: (408) 435-7355. 



